---
title: "List durable JSON keys and revisions"
method: GET
path: "/api/v1/addresses/{addressId}/state"
tags: ["State"]
---

# List durable JSON keys and revisions

`GET /api/v1/addresses/{addressId}/state`

## Request

- Base URL: `https://agentaddress.dev`
- URL: `https://agentaddress.dev/api/v1/addresses/{addressId}/state`
- Auth: HTTP bearer

## Path parameters

- `addressId` string, required

## Response `200`

Authorized response; never cached

- StateKeys
  - `keys` object[], required
    - `key` string, required
    - `revision` integer, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `404`: Structured API error
- `409`: Structured API error
- `429`: Wait Retry-After seconds; minute, hourly or UTC daily window applies

---

[API](https://skmtc.dev/agentaddress/apis/agentaddress-api.md) · [All operations](https://skmtc.dev/agentaddress/apis/agentaddress-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentaddress/apis/agentaddress-api/revisions/e41b8c27b4ca?raw)