{"uid":"cap_DwaAxJdW92PV5bQmiIFMg","slug":"pinata-private-file-retrieval-via-x402-payment-96d7d3b9","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/bafkreig64zjue3vnfqejtq2lmzdhgbbsin7gc7dxdebw3exy4ysjkoq62q","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_4uT709FrNunESEQ4my-xT","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":"Pays $0.001 USDC and retrieves a specific private file stored on Pinata by its CID (bafkreig64zjue3vnfqejtq2lmzdhgbbsin7gc7dxdebw3exy4ysjkoq62q)","exampleAgentPrompt":"Can you retrieve the private Pinata file with CID bafkreig64zjue3vnfqejtq2lmzdhgbbsin7gc7dxdebw3exy4ysjkoq62q for me — it costs $0.001 USDC to unlock?","exampleUseCases":[{"title":"Fetch paywalled IPFS research data","prompt":"I need to grab that private IPFS file with CID bafkreig64zjue3vnfqejtq2lmzdhgbbsin7gc7dxdebw3exy4ysjkoq62q — it's behind a $0.001 USDC paywall on Pinata. Can you handle the micropayment and pull the content for me?"},{"title":"Unlock gated NFT metadata file","prompt":"There's a private Pinata file storing NFT metadata at CID bafkreig64zjue3vnfqejtq2lmzdhgbbsin7gc7dxdebw3exy4ysjkoq62q that I need to access. It requires a tiny USDC payment via x402 — go ahead and pay and retrieve it."},{"title":"Retrieve private decentralized storage asset","prompt":"Can you fetch the gated file stored on Pinata's IPFS at CID bafkreig64zjue3vnfqejtq2lmzdhgbbsin7gc7dxdebw3exy4ysjkoq62q? It costs $0.001 USDC to unlock — please process the payment and bring back the raw content."}],"resultDescription":"Returns the raw content of the private file stored on Pinata identified by the specified CID, after the x402 micropayment of $0.001 USDC is processed and authorized.","failureModes":["Payment insufficient or rejected — x402 payment header missing or USDC balance too low","CID not found — the specified content identifier does not exist or has been unpinned","Unauthorized access — payment processed but file access still denied","Worker timeout — Cloudflare worker fails to respond within time limit","Invalid CID format — malformed content identifier provided in the URL path"],"whenToPreferThis":"Use this endpoint when you need to access a specific private file pinned on Pinata's IPFS infrastructure and are willing to pay a $0.001 USDC micropayment via the x402 protocol. Prefer this over public IPFS gateways when the file is private/gated. This is purpose-built for AI agents that can handle x402 payment flows for decentralized file retrieval.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:33:13.692Z","isFirstParty":false}