# Pinata Private File Retrieval (x402 Pay-per-Access)

> Pinata Private File Retrieval (x402 Pay-per-Access) is a paid API for AI agents from 402-server.pinata-marketing-enterprise.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Accepts a micropayment of $0.001 USDC and returns a private file stored on Pinata IPFS by its CID

## Facts

- Endpoint: POST https://402-server.pinata-marketing-enterprise.workers.dev/v1/retrieve/private/bafkreieoyh26ynfux2pldujpawobz6mqxkvlxcmyu2n6vhfqgcmmd5vh2u
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pinata-private-file-retrieval-x402-pay-per-access-31691f8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_slZHzSQYVBpdnfWjisDbT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pinata-private-file-retrieval-x402-pay-per-access-31691f8d -d '<json body>'
```

Example prompt: Fetch the private Pinata file with CID bafkreieoyh26ynfux2pldujpawobz6mqxkvlxcmyu2n6vhfqgcmmd5vh2u — it costs $0.001 USDC to unlock and download.

## When to prefer this

Use this endpoint when you need to retrieve a specific private file from Pinata IPFS storage that is gated behind a $0.001 USDC micropayment. This is ideal for agent workflows that consume content-addressed private assets programmatically without requiring OAuth or API key setup — just an x402-compatible wallet. Prefer this over public IPFS gateways when the file is private or requires access control enforced by payment.

## Known failure modes

- Payment insufficient or malformed x402 header — 402 Payment Required response
- Invalid or non-existent CID — 404 Not Found
- File is not accessible under this server's Pinata credentials — 403 Forbidden
- Network timeout reaching Pinata storage backend — 504 Gateway Timeout
- CID mismatch or content integrity failure — corrupted or unexpected response body

## How this service works

Pay to retrieve a private file from Pinata by CID

## Output

The raw bytes or content of the private file stored on Pinata at the specified CID, returned after successful x402 micropayment processing. The response contains the actual file data that was previously gated behind payment.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pinata-private-file-retrieval-x402-pay-per-access-31691f8d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402-server.pinata-marketing-enterprise.workers.dev](https://www.zero.xyz/host/402-server.pinata-marketing-enterprise.workers.dev/llms.txt)