{"uid":"cap_f_SuOzBAh6Umgm3opd-zc","slug":"2s-io-c2b2d293","name":"2s.io Agent Memory List","description":"The (most) everything API: one pay-per-call API giving AI agents ground-truth data across hundreds of endpoints — public records, finance, crypto, security, legal, health, geo, and EDI. USDC via x402, no signup, no API keys.","url":"https://2s.io/api/agent/memory/list","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"limit":{"type":"integer","description":"Max items per page (1-100). Default 25."},"cursor":{"type":"string","description":"Opaque cursor from previous response."},"prefix":{"type":"string","description":"Optional key prefix filter."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":50,"prefix":"session_"}}},"response":{"data":{"items":[],"nextCursor":null},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"agent.memory.list","settlement":{"txHash":"0x1b154398b515f076b5034562c706df0b1b2718decbb76d3b67f281ec690f7d7f","network":"eip155:8453","success":true}}}},"exampleRequest":{"limit":50,"prefix":"session_"},"tags":["x402"],"displayCostAmount":"0.001200","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.00","successRate":"0.00","reviews":1,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001200/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o35Mvgi1bp5L1by5jWGr7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0012","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lists keys in the calling agent's memory namespace with cursor pagination, returning metadata only (key, etag, size, timestamps) newest-first.","exampleAgentPrompt":"Show me all the keys currently saved in my agent memory namespace, filtering to ones that start with 'session_', and give me up to 50 per page.","exampleUseCases":[{"title":"Audit agent memory storage usage","prompt":"List all the keys in my agent's memory namespace sorted by size, so I can see what's taking up the most space and clean up if needed."},{"title":"Find recent conversation cache entries","prompt":"Show me the keys I've stored in memory from the last 24 hours, paginating through them so I can review what conversations my agent has cached."},{"title":"Discover saved user context prefixes","prompt":"What keys do I have saved in my agent memory that start with 'user_'? Page through them so I can understand what user data I'm persisting."}],"resultDescription":"Returns a paginated list of memory key metadata objects (key name, etag, sizeBytes, createdAt, updatedAt) sorted newest-first, plus a nextCursor string to fetch the next page. Does not return the stored values themselves — use agent.memory.get for values.","failureModes":["Invalid cursor returns 400 bad request","limit out of range (1-100) returns 400","Unauthorized if x402 signing key does not match namespace","Empty result set with no nextCursor when namespace has no keys or prefix matches nothing","Network timeout on large namespaces"],"whenToPreferThis":"Use this endpoint when an agent needs to enumerate or discover what keys exist in its own memory namespace before deciding which entries to fetch, delete, or update. Prefer this over agent.memory.get when you don't know the exact key name and need to search or browse by prefix.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-06-25T23:13:50.193Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:01:19.693Z","isFirstParty":false}