---
search:
  tags:
    - Agent
    - GET
seo:
  description: >-
    Agent ledger history. Reference for the GET /v1/history endpoint in the
    agentsub Gateway API.
sidebar:
  label: Agent ledger history
  badge: GET
title: Agent ledger history
type: openapi-operation
---
`GET /v1/history`

**Responses**

- `200` — Ledger entries (grants, holds, captures, releases, expiries)
- `401` — \`unauthorized\` problem; live 401s advertise \`WWW-Authenticate: Bearer resource\_metadata=...\`
- `503` — Runtime or provider configuration unavailable (\`runtime\_configuration\_required\`, \`signing\_configuration\_required\`, \`runtime\_unavailable\`, \`workspace\_unavailable\`, \`provider\_configuration\_required\`)

Response example, 200:

```json
{
  "entries": [
    {
      "id": "string",
      "txId": "string",
      "kind": "string",
      "agentId": "string",
      "debitAccountId": "string",
      "creditAccountId": "string",
      "lotId": "string",
      "amountUc": "string",
      "at": 0
    }
  ]
}
```