{"uid":"cap_RaQBCa5-qUVpwsQUm7XDW","slug":"spraay-ipfs-content-gateway-retrieve-by-cid-0ffc35da","name":"Spraay IPFS Content Gateway – Retrieve by CID","description":"Retrieve pinned content by CID.","url":"https://gateway.spraay.app/api/v1/storage/get","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["cid"],"properties":{"cid":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"cid":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aZdmbAVcQBFV-Uo1LcXYy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches pinned content stored on IPFS by its Content Identifier (CID) via the Spraay gateway.","exampleAgentPrompt":"Can you fetch the content pinned on IPFS with CID bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi for me?","exampleUseCases":[{"title":"Retrieve NFT metadata from IPFS","prompt":"I need to read the metadata JSON for an NFT — the CID is bafkreigh2akiscaildcqabab4atxsq2scq7vy5s62hcbz7a4squ4j6ygqq. Can you fetch it from IPFS?"},{"title":"Access decentralized app config file","prompt":"My dApp stores its config on IPFS. Pull the file with CID QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG so I can check the current settings."},{"title":"Download pinned research document","prompt":"I pinned a research paper to IPFS last week — the CID is bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq. Fetch it for me so I can read it."}],"resultDescription":"Returns the raw content of the pinned IPFS object associated with the provided CID — this may be a file, JSON document, image binary, or any other data type that was originally stored. The response includes the content itself along with its CID reference.","failureModes":["Invalid or malformed CID returns an error response","CID not found or not pinned on this gateway returns 404","Payment failure (insufficient USDC balance) blocks the request","Network timeout if the IPFS content is not readily available","Large files may time out or return partial content"],"whenToPreferThis":"Use this endpoint when you need to retrieve content pinned on IPFS and want a pay-per-use gateway accessed via the x402 micropayment protocol without setting up your own IPFS node or gateway infrastructure. Ideal for AI agents operating in Web3 environments that already use Spraay for payments, escrow, or DeFi and want a single integrated platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:41:31.405Z","isFirstParty":false}