Intents
List intents
List intents created by the authenticated agent.
GET
/v1/agent-api/intentsQuery parameters
statusarray of "pending" | "processing" | "completed" | "blocked" | "failed"OptionalPublic intent statuses to include. Repeat to include any of several statuses; omit to include every status.
typearray of "send" | "transfer" | "create_counterparty" | "request_counterparty_details" | "x402" | "mpp" | "policy_override"OptionalIntent types to include. Repeat to include any of several types; omit to include every type.
startstringOptionalInclusive lower bound on the intent creation time
accountIdstringOptionalResolved source account id
limitintegerOptionalMaximum intents to return
offsetintegerOptionalNumber of matching intents to skip
Responses
200Stored intent summaries for this durable agent identity in its organization, newest first. Use GET /intents/{id} for the full intent-specific result.
400Invalid status, type, timestamp, account id, or pagination
Response fields
intentsarray of objectRequiredintents[].idstringRequiredintents[].accountIdstringOptionalintents[].destinationAccountIdstringOptionalintents[].type"send" | "transfer" | "create_counterparty" | "request_counterparty_details" | "x402" | "mpp" | "policy_override"Requiredintents[].status"pending" | "processing" | "completed" | "blocked" | "failed"Requiredintents[].resolution"completed" | "blocked" | "denied" | "expired" | "failed" | "cancelled" or string or nullRequiredExact terminal outcome, or null while the intent is nonterminal. Known values are completed, blocked, denied, expired, failed, and cancelled; clients must preserve future nonblank strings.
intents[].amountmoneyOptionalintents[].counterpartyIdstringOptionalintents[].counterpartyNamestringOptionalintents[].networkstringOptionalintents[].reasonsarray of stringRequiredintents[].expiresAtstring or nullRequiredintents[].createdAtstringRequiredintents[].metadataobjectRequiredtotalnumberRequired