{"uid":"cap_xwTQfiyxXK8t6ygEhx64k","slug":"pinata-private-file-retrieval-via-x402-payment-b45cdf33","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/bafkreifm6sroj5jdnkbjojh5ra5hiybj3rwq52focjvaup7dn5amqll4ne","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":"settled","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_Vj3OETc2AD9ePAA7_YcBF","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":"Retrieve a specific private file stored on Pinata IPFS by its CID, gated behind a $0.001 USDC micropayment","exampleAgentPrompt":"Fetch the private Pinata file with CID bafkreifm6sroj5jdnkbjojh5ra5hiybj3rwq52focjvaup7dn5amqll4ne — it costs $0.001 USDC to access.","exampleUseCases":[{"title":"Retrieve encrypted research data from IPFS","prompt":"I need to access a private research dataset stored on Pinata that someone shared with me. The CID is bafkreib4xn7sxj3k2m8vqp9r6t2w5z7q4c8d9e0f1g2h3i4j5k6l7m8n9o0p1. Go ahead and pay the micropayment to pull it down for me."},{"title":"Download paywalled blockchain analytics reports","prompt":"Grab the latest blockchain transaction analysis report from Pinata for me. The content ID is bafkreias7t6n5m4l3k2j1i9h8g7f6e5d4c3b2a1z9y8x7w6v5u4t3s2r1q0p. I'm willing to pay the small fee to access it."},{"title":"Access premium AI model weights and configs","prompt":"I need to fetch a fine-tuned model checkpoint that was stored privately on Pinata. The CID is bafkreih9k8j7i6h5g4f3e2d1c0b9a8z7y6x5w4v3u2t1s0r9q8p7o6n5m4l3k. Pull it down for me and handle the payment."}],"resultDescription":"The raw bytes or content of the private file stored on Pinata at the specified CID, returned after successful x402 micropayment verification.","failureModes":["Payment insufficient or missing — returns 402 Payment Required","Invalid or malformed CID — returns 404 Not Found","CID does not correspond to a Pinata-hosted private file — returns 404","Payment verification failure — returns 402 or 403","Network/worker timeout — returns 503","Unauthorized access if payment not confirmed by facilitator"],"whenToPreferThis":"Use this endpoint when you need to retrieve a specific private file stored on Pinata IPFS whose CID is already known, and you are willing to pay $0.001 USDC per retrieval via the x402 payment protocol. Ideal for AI agents operating in Web3 environments that need to access paywalled or private decentralized content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:17.831Z","isFirstParty":false}