{"uid":"cap_WUOs--5IzdyBVU38dIcw8","slug":"pinata-private-file-retrieval-via-x402-payment-34abb573","name":"Pinata Private File Retrieval via x402 Payment","description":"Pay to retrieve a private file from Pinata by CID","url":"https://402-server.pinata-marketing-enterprise.workers.dev/v1/retrieve/private/bafkreigapts2hedc4n2in6c5bj7x4eclx4ergaizi7naalcehkhcza7dxa","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_b2EB49n0BncU174QATIZj","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":"Pay $0.001 USDC to retrieve a private file stored on Pinata IPFS by its CID (Content Identifier)","exampleAgentPrompt":"Can you fetch the private Pinata file with CID bafkreigapts2hedc4n2in6c5bj7x4eclx4ergaizi7naalcehkhcza7dxa for me? I'm okay paying the $0.001 USDC retrieval fee.","exampleUseCases":null,"resultDescription":"The raw content of the private file stored on Pinata, returned after successful micropayment authorization via x402 protocol. The agent receives the file bytes or content corresponding to the requested CID.","failureModes":["Payment insufficient or rejected — x402 payment not processed, file not returned","Invalid or unknown CID — file not found on Pinata","CID does not correspond to a private file accessible via this gateway","Expired or malformed payment token — 402 payment header rejected","Network or Cloudflare Worker timeout — service temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need to access a specific private file pinned on Pinata's IPFS service identified by a known CID, and you are willing to make a small USDC micropayment via the x402 protocol. Prefer this over public IPFS gateways when the file is private/gated and requires payment authorization.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:31:00.906Z","isFirstParty":false}