# TzKT Bigmap by ID Lookup

> TzKT Bigmap by ID Lookup is a paid API for AI agents from x402.tzkt.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Retrieves a specific Tezos smart contract bigmap entry by its numeric ID from the TzKT blockchain indexer.

## Facts

- Endpoint: POST https://x402.tzkt.io/v1/bigmaps/%7Bid%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tzkt-bigmap-by-id-lookup-db541280
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SWpKj18BhUkqHEf7b1nn3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tzkt-bigmap-by-id-lookup-db541280 -d '<json body>'
```

Example prompt: Can you pull up the details for Tezos bigmap ID 12345 from TzKT — I need to know its key type, value type, and which contract it belongs to?

## When to prefer this

Choose this endpoint when you need structured metadata about a specific Tezos smart contract bigmap by its numeric ID, especially for auditing contract storage, building Tezos indexing pipelines, or enriching DeFi analytics dashboards. It requires no API key and is faster than parsing raw Tezos node RPC responses. Prefer TzKT over raw Tezos RPC when you need pre-indexed, human-readable bigmap metadata rather than raw Michelson.

## Known failure modes

- Bigmap ID not found — returns 404 if the numeric ID does not exist on the Tezos mainnet
- Invalid ID format — non-integer or malformed path parameter causes a 400 error
- Network or node unavailability — TzKT indexer may be temporarily unreachable
- Payment failure — x402 micropayment of 0.002 USDC not accepted leads to 402 response

## How this service works

TzKT is a comprehensive Tezos blockchain indexer API. Access blocks, operations, accounts, contracts, bigmaps, delegates, tokens and network stats through a fast REST API. No signup or API key required.

## Output

Returns a JSON object describing the specified bigmap, including its numeric ID, the contract address that owns it, the Michelson key and value types, the total number of keys, active key count, and indexing timestamps.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tzkt-bigmap-by-id-lookup-db541280/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tzkt.io](https://www.zero.xyz/host/x402.tzkt.io/llms.txt)