/operations/{id}

GET/v1/agent/operations/{id}

Get one AgentOperation

Requires API-key authentication (agentAuth, agentId).

Purpose: fetch one operation scoped to the authenticated agent.

Auth and scope: header-key auth or OAuth agent:read.

Idempotency: not required.

Path params:

json

example

{
  "id": "operation uuid"
}

Query:

json

example

{
  "include": "onchain"
}

include=onchain is optional.

Response:

error response

application/json

{
  "ok": true,
  "operation": {
    "id": "uuid",
    "idempotency_key_hash": "sha256 hex or null",
    "type": "payment",
    "status": "submitted",
    "resource": {
      "type": "payment",
      "id": "uuid"
    },
    "amount_usd": "1",
    "asset_symbol": "USDC",
    "human_message": "string",
    "fee_usd": "0",
    "created_at": "2026-05-16T00:00:00.000Z",
    "submitted_at": "2026-05-16T00:00:01.000Z",
    "executed_at": "2026-05-16T00:00:30.000Z",
    "failed_at": "2026-05-16T00:00:30.000Z",
    "error": {
      "code": "string",
      "message": "string"
    },
    "onchain": {
      "chain_id": 8453,
      "wallet_address": "0x...",
      "manager_address": "0x...",
      "agent_wrapper_address": "0x...",
      "agent_sender_address": "0x...",
      "tx_hash": "0x...",
      "user_operation_hash": "0x...",
      "bundler_hash": "0x...",
      "raw_destination_address": "0x...",
      "tx_calldata": "0x..."
    }
  }
}

Common errors: not_found, insufficient_scope, rate_limited.

Related recipe: any operation-backed recipe on this page.