{"uid":"cap_slZHzSQYVBpdnfWjisDbT","slug":"pinata-private-file-retrieval-x402-pay-per-access-31691f8d","name":"Pinata Private File Retrieval (x402 Pay-per-Access)","description":"Pay to retrieve a private file from Pinata by CID","url":"https://402-server.pinata-marketing-enterprise.workers.dev/v1/retrieve/private/bafkreieoyh26ynfux2pldujpawobz6mqxkvlxcmyu2n6vhfqgcmmd5vh2u","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NWDTooOU5i5fKhJ3z6uEo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Accepts a micropayment of $0.001 USDC and returns a private file stored on Pinata IPFS by its CID","exampleAgentPrompt":"Fetch the private Pinata file with CID bafkreieoyh26ynfux2pldujpawobz6mqxkvlxcmyu2n6vhfqgcmmd5vh2u — it costs $0.001 USDC to unlock and download.","exampleUseCases":[{"title":"Retrieve encrypted medical records by content hash","prompt":"I need to pull the encrypted patient file stored on Pinata with CID QmX7k9mL2pQr4sT8vW1xY5zA3bC6dE9fG2hI4jK7lM0nO — it's a private medical record that costs a thousandth of a cent to unlock."},{"title":"Access paywalled research datasets on demand","prompt":"Can you grab the proprietary dataset we stored on Pinata with CID bafkrei5n9z2mK8wL3pQ6rS7tU0vX1yZ4aB5cD8eF1gH2iJ3kL4mN5oP6qR7sT — we pay a small micropayment per access to keep it private."},{"title":"Unlock subscription-gated digital content files","prompt":"Pull down the premium ebook from our Pinata vault using CID bafkreif7hJ2kL1mN3oP4qR5sT6uV7wX8yZ9aB0cD1eF2gH3iJ4kL5mN6oP7qR — each download triggers a $0.001 USDC payment through the x402 protocol."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:40:26.634Z","isFirstParty":false}