---
title: "List intents created by the authenticated agent"
method: GET
path: "/intents"
tags: ["intents"]
---

# List intents created by the authenticated agent

`GET /intents`

## Request

- Base URL: `https://api.catena.com/v1/agent-api`
- URL: `https://api.catena.com/v1/agent-api/intents`
- Auth: HTTP bearer

## Query parameters

- `status` string[]
- `type` string[]
- `start` string, date-time
- `accountId` string
- `limit` integer
- `offset` integer

## Response `200`

Stored intent summaries for this durable agent identity in its organization, newest first. Use GET /intents/{id} for the full intent-specific result.

- object
  - `intents` object[], required
    - `id` string, required
    - `accountId` string
    - `destinationAccountId` string
    - `type` 'send' | 'transfer' | 'create_counterparty' | 'request_counterparty_details' | 'x402' | 'mpp' | 'policy_override' | 'policy_proposal' | 'card_purchase', required
    - `status` 'pending' | 'processing' | 'completed' | 'blocked' | 'failed', required
    - `resolution` union, required: Exact 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.
      - 'completed' | 'blocked' | 'denied' | 'expired' | 'failed' | 'cancelled'
      - string
    - `amount` object
      - `amount` string, required
      - `assetId` string, required
      - `asset_id` string, required
    - `counterpartyId` string
    - `counterpartyName` string
    - `network` string
    - `reasons` string[], required
    - `expiresAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `metadata` object, required
      - `dataUrl` string, nullable, required
    - `evidence` object: The evidence submitted with the intent, keyed by field key: text exactly as sent, or a file's details. Absent when the intent carries none
  - `total` number, required

## Other responses

- `400`: Invalid status, type, timestamp, account id, or pagination
- `409`: Refused: the agent's policy cannot be read (`policy_unreadable`) until an admin saves its full configuration or, for a temporary override, revokes it and grants a new one; nothing changed, and GET /policy shows it with `invalidReason`

---

[API](https://skmtc.dev/catena/apis/catena-agent-api.md) - [All operations](https://skmtc.dev/catena/apis/catena-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/catena/apis/catena-agent-api/revisions/9b72e32d21f1?raw)