{"uid":"cap_lc7Z37wCflbRHJVrFe_j4","slug":"2s-store-document-get-54014a7b","name":"2s Store Document Get","description":"The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.","url":"https://2s.io/api/store/doc-get","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":"string","description":"Document id to fetch."},"ns":{"type":"string","description":"Namespace the document lives in."}}},"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_-Kb1BFMLjb_OJeikblTr2","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 a stored document by ID from a named namespace in the 2s key-value document store","exampleAgentPrompt":"Fetch the document with ID 'agent-state-001' from the 'my-workflow' namespace in the 2s store and show me its body and when it expires.","exampleUseCases":[{"title":"Agent state retrieval mid-workflow","prompt":"Pull up the document with ID 'session-42' from the 'agent-sessions' namespace in the 2s store — I need to resume where I left off."},{"title":"Cached config lookup for automation","prompt":"Get the document 'rate-limits-v2' from the 'app-config' namespace in 2s so we can check the current limits before making any API calls."},{"title":"Verify stored research artifact","prompt":"Retrieve the document 'research-summary-june' from the 'research-cache' namespace in 2s and show me the full body and its expiry date."}],"resultDescription":"Returns a JSON object with ok=true, an items array containing matching documents (each with id, body string, optional meta, and expiresAt timestamp), a total count (or null if unknown), and a source object with provider name, URL, and license information.","failureModes":["Document ID not found — returns empty items array with total 0","Invalid or missing namespace — may return empty result or error","Expired document — may not be returned if TTL has elapsed","Malformed request body — returns error response","Payment failure — x402 payment not accepted, endpoint not called"],"whenToPreferThis":"Use this endpoint when you need to retrieve a previously stored document from the 2s key-value document store by its exact ID and namespace. Prefer this over alternatives when you are already using the 2s ecosystem for agent infrastructure, need pay-per-call pricing with no API key setup, and want to retrieve structured document bodies with expiry metadata. Not appropriate for full-text search or listing documents — use it only when you have the specific document ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:31.583Z","isFirstParty":false}