{"uid":"cap_hRxxLYTaZjOzar0Na3e_f","slug":"x402-api-agentmail-to-4c0a5322","name":"AgentMail List Inboxes","description":"List Inboxes","url":"https://x402.api.agentmail.to/v0/inboxes","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"ascending":{"type":"boolean","title":"Ascending","description":"Sort in ascending temporal order."},"page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"responseSchema":{"type":"object","title":"ListInboxesResponse","required":["count","inboxes"],"properties":{"count":{"type":"integer","title":"Count","description":"Number of items returned."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"inboxes":{"type":"array","items":{"type":"object","title":"Inbox","required":["pod_id","inbox_id","updated_at","created_at"],"properties":{"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"client_id":{"type":"string","title":"ClientId","description":"Client ID of inbox."},"created_at":{"type":"string","format":"date-time","description":"Time at which inbox was created."},"updated_at":{"type":"string","format":"date-time","description":"Time at which inbox was last updated."},"display_name":{"type":"string","title":"DisplayName","description":"Display name: `Display Name <username@domain.com>`."}}},"description":"Ordered by `created_at` descending."},"next_page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RJwTPAr2ZPwfUh3CGMLb5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a list of all email inboxes available in the AgentMail organization for use by AI agents","exampleAgentPrompt":"Show me all the email inboxes set up in my AgentMail account so I know which ones my agent can send and receive from.","exampleUseCases":null,"resultDescription":"A JSON array of inbox objects, each containing inbox identifiers, addresses, and associated metadata for all inboxes provisioned under the agent's organization.","failureModes":["Unauthorized access if credentials are missing or invalid (401)","No inboxes found if none have been provisioned (empty array)","Rate limiting if too many requests are made in quick succession (429)","Service unavailable during maintenance windows (503)"],"whenToPreferThis":"Use this endpoint when an AI agent needs to discover which email inboxes are available before sending, reading, or managing email. This is the right starting point for any email workflow — call it first to enumerate available inbox IDs that can then be passed to thread, draft, or message endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":5,"lastUsedAt":"2026-08-08T20:06:24.248Z","lastSuccessfullyRanAt":"2026-08-08T20:06:24.248Z","lastHealthCheckAt":"2026-09-15T12:52:27.748Z","isFirstParty":false}