Skip to main content

​
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

​
limit
integer
default:"25"
Number of anchors to return (max 100).

​
Response

{
  "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

FieldTypeDescription
idstringUnique anchor identifier
merkle_rootstring64-character hex SHA-256 Merkle root of events in this period
previous_anchor_hashstring | nullSHA-256 hash of the previous anchor’s merkle_root + tx_hash. Null for the first anchor
events_countintegerNumber of events included in the Merkle tree
period_startstringISO 8601 start of the anchoring period
period_endstringISO 8601 end of the anchoring period
chainstringBlockchain network (base)
statusstringpending, submitted, or confirmed
tx_hashstring | nullBlockchain transaction hash. Null if not yet submitted
block_numberinteger | nullBlock number of the confirmed transaction. Null if not yet confirmed
explorer_urlstring | nullDirect link to the transaction on Basescan
created_atstringISO 8601 timestamp of anchor creation

​
Examples

curl https://getimmutable.dev/api/v1/anchors?limit=10 \
  -H "Authorization: Bearer imk_your_api_key_here"
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.