> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getimmutable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Anchors

> Retrieve blockchain anchors for your workspace.

## GET /api/v1/anchors

Retrieve a list of blockchain anchors for your workspace, ordered by creation date (newest first). Each anchor represents a Merkle root computed from events in a given period and submitted to the Base blockchain.

### Query Parameters

<ParamField query="limit" type="integer" default="25">
  Number of anchors to return (max 100).
</ParamField>

### Response

```json theme={null}
{
  "data": [
    {
      "id": "anc_abc123",
      "merkle_root": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "previous_anchor_hash": "4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e4729b49fce",
      "events_count": 1247,
      "period_start": "2026-03-27T00:00:00Z",
      "period_end": "2026-03-27T23:59:59Z",
      "chain": "base",
      "status": "confirmed",
      "tx_hash": "0x7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b",
      "block_number": 28451923,
      "explorer_url": "https://basescan.org/tx/0x7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b",
      "created_at": "2026-03-28T00:15:32Z"
    },
    {
      "id": "anc_def456",
      "merkle_root": "6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b",
      "previous_anchor_hash": null,
      "events_count": 892,
      "period_start": "2026-03-26T00:00:00Z",
      "period_end": "2026-03-26T23:59:59Z",
      "chain": "base",
      "status": "confirmed",
      "tx_hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
      "block_number": 28409871,
      "explorer_url": "https://basescan.org/tx/0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
      "created_at": "2026-03-27T00:15:28Z"
    }
  ]
}
```

### Response Fields

| Field                  | Type            | Description                                                                                |
| ---------------------- | --------------- | ------------------------------------------------------------------------------------------ |
| `id`                   | string          | Unique anchor identifier                                                                   |
| `merkle_root`          | string          | 64-character hex SHA-256 Merkle root of events in this period                              |
| `previous_anchor_hash` | string \| null  | SHA-256 hash of the previous anchor's `merkle_root` + `tx_hash`. Null for the first anchor |
| `events_count`         | integer         | Number of events included in the Merkle tree                                               |
| `period_start`         | string          | ISO 8601 start of the anchoring period                                                     |
| `period_end`           | string          | ISO 8601 end of the anchoring period                                                       |
| `chain`                | string          | Blockchain network (`base`)                                                                |
| `status`               | string          | `pending`, `submitted`, or `confirmed`                                                     |
| `tx_hash`              | string \| null  | Blockchain transaction hash. Null if not yet submitted                                     |
| `block_number`         | integer \| null | Block number of the confirmed transaction. Null if not yet confirmed                       |
| `explorer_url`         | string \| null  | Direct link to the transaction on Basescan                                                 |
| `created_at`           | string          | ISO 8601 timestamp of anchor creation                                                      |

### Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://getimmutable.dev/api/v1/anchors?limit=10 \
    -H "Authorization: Bearer imk_your_api_key_here"
  ```

  ```typescript JavaScript theme={null}
  import { ImmutableClient } from "getimmutable";

  const client = new ImmutableClient({
    apiKey: "imk_your_api_key_here",
    baseUrl: "https://getimmutable.dev",
  });

  const anchors = await client.getAnchors(10);

  for (const anchor of anchors.data) {
    console.log(`${anchor.id}: ${anchor.events_count} events, status: ${anchor.status}`);
  }
  ```

  ```python Python theme={null}
  from getimmutable import ImmutableClient

  client = ImmutableClient(
      api_key="imk_your_api_key_here",
      base_url="https://getimmutable.dev",
  )

  anchors = client.get_anchors(limit=10)

  for anchor in anchors["data"]:
      print(f"{anchor['id']}: {anchor['events_count']} events, status: {anchor['status']}")
  ```

  ```php Laravel theme={null}
  use GetImmutable\AuditLog;

  $anchors = AuditLog::client()->getAnchors();

  foreach ($anchors['data'] as $anchor) {
      echo "{$anchor['id']}: {$anchor['events_count']} events\n";
  }
  ```
</CodeGroup>

<Note>
  Anchors with `status: "pending"` or `status: "submitted"` will have null values for `tx_hash`, `block_number`, and `explorer_url`. These anchors cannot yet be verified on-chain.
</Note>