Sepolia TestnetChainID 11155111Block~12sAnchor checkevery 12hEpoch24h (UTC day)Records:—

Explorer API Reference

Every endpoint powering this explorer is public, unauthenticated, and returns JSON wrapped in a { data, meta } envelope.

Response Envelope

All endpoints return the same shape:

json

{
  "data": { /* endpoint-specific payload */ },
  "meta": { /* pagination, generated_at, filters, counts */ }
}

Rate Limits

None currently

Auth

Public, no API key required

Caching

30-60s revalidation per route

Errors

{ "error": "..." }

Endpoints

Chain Stats3 Blocks2 Transactions1 Audit Hashes1 Epochs1 Record Types2 Search1 Aircraft1

Chain Stats

High-level aggregates and head info.

GET/api/explorer/stats

Dashboard summary: totals, 24h/7d activity, latest tx/block/epoch, and a 14-day records-per-day series.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/stats

Example Response

json

{
  "data": {
    "totals": { "records": 12847, "anchored_records": 12190, "batches": 482, "epochs": 12 },
    "latest": {
      "block_number": 7894214,
      "tx_hash": "0xabc...",
      "anchored_at": "2026-05-19T14:23:11Z",
      "merkle_root": "0x12f...",
      "record_count": 28,
      "epoch_number": 12,
      "epoch_label": "Epoch 12",
      "epoch_id": "uuid"
    },
    "activity": { "h24": 312, "d7": 1804, "sealed_per_day": [...] },
    "chain": { "name": "Sepolia", "chain_id": 11155111 }
  },
  "meta": { "generated_at": "2026-05-19T14:24:00Z", "window_days": 14 }
}

GET/api/explorer/head

Current chain head from our RPC poller. Includes a stale flag if our last fetch is older than 30s.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/head

Example Response

json

{
  "block_number": "0x787...",
  "block_number_num": 7894220,
  "fetched_at": "2026-05-19T14:24:30Z",
  "stale": false
}

GET/api/explorer/analytics

Deep analytics: per-epoch counts, batch-size series, record-type breakdown, 30-day daily activity, and top scopes.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/analytics

Example Response

json

{
  "data": {
    "totals": { "records": 12847, "batches": 482, "epochs": 12, "avg_records_per_batch": 26.65, "avg_batches_per_epoch": 40.17 },
    "records_per_epoch": [{ "epoch_id": "uuid", "epoch_number": 1, "label": "Epoch 1", "count": 920 }],
    "batch_sizes": [{ "date": "2026-05-19T14:23:11Z", "batch_id": "uuid", "record_count": 28 }],
    "type_breakdown": [{ "record_type": "work_orders", "count": 4012, "pct": 31.2 }],
    "daily_activity_30d": [{ "date": "2026-04-19", "records": 312, "batches": 12 }],
    "top_scopes": [{ "scope_type": "aircraft", "scope_id": "uuid", "display_id": "0xAC.a1b2c3d4", "record_count": 540 }]
  },
  "meta": { "generated_at": "...", "window_days": 30, "batch_sample_size": 482, "type_sample_size": 12847 }
}

Blocks

Sepolia blocks our anchor transactions have landed in.

GET/api/explorer/blocks

Paginated list of distinct blocks containing at least one anchored batch.

Query Parameters

limit

integer · default 20

Number of blocks to return (1-100).

offset

integer · default 0

Pagination offset.

Example Request

bash

curl "https://blockchain.myaviationtools.com/api/explorer/blocks?limit=10"

Example Response

json

{
  "data": [
    {
      "block_number": 7894214,
      "anchor_count": 1,
      "total_records": 28,
      "first_seen": "2026-05-19T14:23:11Z",
      "last_seen":  "2026-05-19T14:23:11Z",
      "batches": [{ "id": "uuid", "merkle_root": "0x...", "tx_hash": "0x...", "record_count": 28, "anchored_at": "..." }]
    }
  ],
  "meta": { "limit": 10, "offset": 0, "returned_count": 10, "has_more": true, "chain_id": 11155111 }
}

GET/api/explorer/blocks/{blockNumber}

Single block detail: every batch we anchored to this block, sample audit hashes, and epoch info.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/blocks/7894214

Example Response

json

{
  "data": {
    "block_number": 7894214,
    "etherscan_block_url": "https://sepolia.etherscan.io/block/7894214",
    "chain": "sepolia",
    "chain_id": 11155111,
    "anchor_count": 1,
    "total_records": 28,
    "batches": [...]
  },
  "meta": { "sample_per_batch": 5, "epoch_count": 1 }
}

Transactions

Individual anchor transactions and their record contents.

GET/api/explorer/tx/{txHash}

Full transaction detail: batch info, audit hashes contained, epoch, gas.

Query Parameters

limit

integer · default 100

Number of audit_hashes to return.

offset

integer · default 0

Pagination offset within audit_hashes.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/tx/0xabc123...

Example Response

json

{
  "data": {
    "tx_hash": "0x...",
    "etherscan_tx_url": "https://sepolia.etherscan.io/tx/0x...",
    "chain": "sepolia",
    "chain_id": 11155111,
    "batch": { "id": "uuid", "merkle_root": "0x...", "record_count": 28, "gas_used": "230000", "anchored_at": "..." },
    "block": { "number": 7894214, "etherscan_block_url": "..." },
    "epoch": { "id": "uuid", "number": 12, "label": "Epoch 12" },
    "audit_hashes": [...]
  },
  "meta": { "limit": 100, "offset": 0, "total": 28, "has_more": false }
}

Audit Hashes

Individual record-level audit hashes — the leaves of the Merkle tree.

GET/api/explorer/audit/{auditHashId}

Single audit-hash detail: full audit row, batch + block + epoch + Merkle proof, IPFS pin, and (best-effort) the source-table record.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/audit/00000000-0000-0000-0000-000000000000

Example Response

json

{
  "data": {
    "audit_hash": { "id": "uuid", "record_hash": "0x...", "record_type": "work_orders", "record_id": "uuid", "created_at": "...", "ipfs_cid": "bafy..." },
    "display_id": { "display_id": "0xWO.a1b2c3d4", "record_type": "work_orders", "record_id": "uuid" },
    "batch": { "id": "uuid", "merkle_root": "0x...", "record_count": 28, "tx_hash": "0x...", "block_number": 7894214, "anchored_at": "..." },
    "block": { "number": 7894214, "etherscan_block_url": "..." },
    "epoch": { "id": "uuid", "number": 12, "label": "Epoch 12" },
    "merkle_proof": { "leaf_index": 12, "leaves": [...], "siblings": [...], "root": "0x..." },
    "confirmation": { "chain_block_number": 7894214 },
    "ipfs": { "cid": "bafy...", "url": "https://gateway.pinata.cloud/ipfs/bafy..." },
    "source_record": {...},
    "source_table": "work_orders"
  },
  "meta": { "has_source_record": true, "source_record_fetched_from": "work_orders" }
}

Epochs

Time-bucketed groupings of anchored batches.

GET/api/explorer/epoch/{idOrNumber}

Epoch detail: every batch in the epoch with block + tx info plus aggregate stats.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/epoch/12

Example Response

json

{
  "data": {
    "epoch": { "id": "uuid", "number": 12, "label": "Epoch 12", "started_at": "...", "ended_at": "...", "status": "closed", "merkle_root": "0x...", "batch_count": 40, "record_count": 1064 },
    "batches": [{ "id": "uuid", "merkle_root": "0x...", "record_count": 28, "tx_hash": "0x...", "block_number": 7894214, "anchored_at": "...", "etherscan_tx_url": "..." }],
    "aggregate": { "total_records": 1064, "batch_count": 40, "distinct_record_types": 9, "earliest_record_at": "...", "latest_record_at": "..." }
  },
  "meta": { "chain": "sepolia", "chain_id": 11155111, "epochs_lib_present": true }
}

Record Types

Browse audit hashes grouped by their record_type.

GET/api/explorer/types

Every distinct record_type with counts, anchored/pending split, first/last seen, and a sample display_id.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/types

Example Response

json

{
  "data": [
    {
      "record_type": "work_orders",
      "count": 4012,
      "anchored_count": 3892,
      "pending_count": 120,
      "first_seen": "2026-01-12T...",
      "last_seen":  "2026-05-19T...",
      "sample_record_id": "uuid",
      "sample_display_id": "0xWO.a1b2c3d4"
    }
  ],
  "meta": { "total_types": 11, "sampled_rows": 12847, "truncated": false }
}

GET/api/explorer/types/{recordType}

Paginated list of audit_hashes for one record type, optionally filtered by since (ISO) and anchored status.

Query Parameters

limit

integer · default 25

Number of rows (1-100).

offset

integer · default 0

Pagination offset.

since

string (ISO)

Only records created after this timestamp.

anchored

true | false

Filter to anchored or pending only.

Example Request

bash

curl "https://blockchain.myaviationtools.com/api/explorer/types/work_orders?limit=25&anchored=true"

Example Response

json

{
  "data": {
    "record_type": "work_orders",
    "total": 4012,
    "first_seen": "2026-01-12T...",
    "last_seen": "2026-05-19T...",
    "audit_hashes": [
      {
        "id": "uuid",
        "record_hash": "0x...",
        "record_id": "uuid",
        "display_id": "0xWO.a1b2c3d4",
        "ipfs_cid": "bafy...",
        "created_at": "2026-05-19T...",
        "scope_type": "aircraft",
        "scope_id": "uuid",
        "batch_id": "uuid",
        "block_number": 7894214,
        "tx_hash": "0x...",
        "anchored_at": "2026-05-19T...",
        "anchored": true
      }
    ]
  },
  "meta": { "limit": 25, "offset": 0, "has_more": true, "total": 4012, "returned_count": 25, "filters": { "since": null, "anchored": "true" } }
}

Search

Universal search across hashes, transactions, blocks, and display IDs.

GET/api/explorer/search

Resolve any user-pasted identifier — record hash, tx hash, block number, audit UUID, or display ID (e.g. 0xAC.xxxxxxxx).

Query Parameters

q *

string

The search query.

Example Request

bash

curl "https://blockchain.myaviationtools.com/api/explorer/search?q=0xAC.a1b2c3d4"

Example Response

json

{
  "data": {
    "kind": "aircraft",
    "redirect": "/explorer/aircraft/0xAC.a1b2c3d4"
  },
  "meta": { "query": "0xAC.a1b2c3d4" }
}

Aircraft

Per-aircraft on-chain history.

GET/api/explorer/aircraft/{displayId}

All audit_hashes scoped to one aircraft (by 0xAC.xxxxxxxx display ID), grouped by epoch.

Query Parameters

limit

integer · default 50

Page size (1-100).

offset

integer · default 0

Pagination offset.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/aircraft/0xAC.a1b2c3d4

Example Response

json

{
  "data": {
    "aircraft": { "display_id": "0xAC.a1b2c3d4", "record_id": "uuid" },
    "summary": { "total_records": 540, "distinct_epochs": 8, "first_anchored_at": "...", "last_anchored_at": "...", "latest_block_number": 7894214, "latest_tx_hash": "0x..." },
    "epoch_breakdown": [...],
    "records": [...]
  },
  "meta": { "limit": 50, "offset": 0, "total": 540, "returned_count": 50, "has_more": true }
}

Aviation Blockchain Explorer

Verify maintenance records anchored to Sepolia (Ethereum testnet). Search by hash, tail number, serial, or batch ID.

Explorer API Reference

Every endpoint powering this explorer is public, unauthenticated, and returns JSON wrapped in a { data, meta } envelope.

Response Envelope

All endpoints return the same shape:

json

{
  "data": { /* endpoint-specific payload */ },
  "meta": { /* pagination, generated_at, filters, counts */ }
}

Rate Limits

None currently

Auth

Public, no API key required

Caching

30-60s revalidation per route

Errors

{ "error": "..." }

Endpoints

Chain Stats3 Blocks2 Transactions1 Audit Hashes1 Epochs1 Record Types2 Search1 Aircraft1

Chain Stats

High-level aggregates and head info.

GET/api/explorer/stats

Dashboard summary: totals, 24h/7d activity, latest tx/block/epoch, and a 14-day records-per-day series.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/stats

Example Response

json

{
  "data": {
    "totals": { "records": 12847, "anchored_records": 12190, "batches": 482, "epochs": 12 },
    "latest": {
      "block_number": 7894214,
      "tx_hash": "0xabc...",
      "anchored_at": "2026-05-19T14:23:11Z",
      "merkle_root": "0x12f...",
      "record_count": 28,
      "epoch_number": 12,
      "epoch_label": "Epoch 12",
      "epoch_id": "uuid"
    },
    "activity": { "h24": 312, "d7": 1804, "sealed_per_day": [...] },
    "chain": { "name": "Sepolia", "chain_id": 11155111 }
  },
  "meta": { "generated_at": "2026-05-19T14:24:00Z", "window_days": 14 }
}

GET/api/explorer/head

Current chain head from our RPC poller. Includes a stale flag if our last fetch is older than 30s.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/head

Example Response

json

{
  "block_number": "0x787...",
  "block_number_num": 7894220,
  "fetched_at": "2026-05-19T14:24:30Z",
  "stale": false
}

GET/api/explorer/analytics

Deep analytics: per-epoch counts, batch-size series, record-type breakdown, 30-day daily activity, and top scopes.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/analytics

Example Response

json

{
  "data": {
    "totals": { "records": 12847, "batches": 482, "epochs": 12, "avg_records_per_batch": 26.65, "avg_batches_per_epoch": 40.17 },
    "records_per_epoch": [{ "epoch_id": "uuid", "epoch_number": 1, "label": "Epoch 1", "count": 920 }],
    "batch_sizes": [{ "date": "2026-05-19T14:23:11Z", "batch_id": "uuid", "record_count": 28 }],
    "type_breakdown": [{ "record_type": "work_orders", "count": 4012, "pct": 31.2 }],
    "daily_activity_30d": [{ "date": "2026-04-19", "records": 312, "batches": 12 }],
    "top_scopes": [{ "scope_type": "aircraft", "scope_id": "uuid", "display_id": "0xAC.a1b2c3d4", "record_count": 540 }]
  },
  "meta": { "generated_at": "...", "window_days": 30, "batch_sample_size": 482, "type_sample_size": 12847 }
}

Blocks

Sepolia blocks our anchor transactions have landed in.

GET/api/explorer/blocks

Paginated list of distinct blocks containing at least one anchored batch.

Query Parameters

limit

integer · default 20

Number of blocks to return (1-100).

offset

integer · default 0

Pagination offset.

Example Request

bash

curl "https://blockchain.myaviationtools.com/api/explorer/blocks?limit=10"

Example Response

json

{
  "data": [
    {
      "block_number": 7894214,
      "anchor_count": 1,
      "total_records": 28,
      "first_seen": "2026-05-19T14:23:11Z",
      "last_seen":  "2026-05-19T14:23:11Z",
      "batches": [{ "id": "uuid", "merkle_root": "0x...", "tx_hash": "0x...", "record_count": 28, "anchored_at": "..." }]
    }
  ],
  "meta": { "limit": 10, "offset": 0, "returned_count": 10, "has_more": true, "chain_id": 11155111 }
}

GET/api/explorer/blocks/{blockNumber}

Single block detail: every batch we anchored to this block, sample audit hashes, and epoch info.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/blocks/7894214

Example Response

json

{
  "data": {
    "block_number": 7894214,
    "etherscan_block_url": "https://sepolia.etherscan.io/block/7894214",
    "chain": "sepolia",
    "chain_id": 11155111,
    "anchor_count": 1,
    "total_records": 28,
    "batches": [...]
  },
  "meta": { "sample_per_batch": 5, "epoch_count": 1 }
}

Transactions

Individual anchor transactions and their record contents.

GET/api/explorer/tx/{txHash}

Full transaction detail: batch info, audit hashes contained, epoch, gas.

Query Parameters

limit

integer · default 100

Number of audit_hashes to return.

offset

integer · default 0

Pagination offset within audit_hashes.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/tx/0xabc123...

Example Response

json

{
  "data": {
    "tx_hash": "0x...",
    "etherscan_tx_url": "https://sepolia.etherscan.io/tx/0x...",
    "chain": "sepolia",
    "chain_id": 11155111,
    "batch": { "id": "uuid", "merkle_root": "0x...", "record_count": 28, "gas_used": "230000", "anchored_at": "..." },
    "block": { "number": 7894214, "etherscan_block_url": "..." },
    "epoch": { "id": "uuid", "number": 12, "label": "Epoch 12" },
    "audit_hashes": [...]
  },
  "meta": { "limit": 100, "offset": 0, "total": 28, "has_more": false }
}

Audit Hashes

Individual record-level audit hashes — the leaves of the Merkle tree.

GET/api/explorer/audit/{auditHashId}

Single audit-hash detail: full audit row, batch + block + epoch + Merkle proof, IPFS pin, and (best-effort) the source-table record.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/audit/00000000-0000-0000-0000-000000000000

Example Response

json

{
  "data": {
    "audit_hash": { "id": "uuid", "record_hash": "0x...", "record_type": "work_orders", "record_id": "uuid", "created_at": "...", "ipfs_cid": "bafy..." },
    "display_id": { "display_id": "0xWO.a1b2c3d4", "record_type": "work_orders", "record_id": "uuid" },
    "batch": { "id": "uuid", "merkle_root": "0x...", "record_count": 28, "tx_hash": "0x...", "block_number": 7894214, "anchored_at": "..." },
    "block": { "number": 7894214, "etherscan_block_url": "..." },
    "epoch": { "id": "uuid", "number": 12, "label": "Epoch 12" },
    "merkle_proof": { "leaf_index": 12, "leaves": [...], "siblings": [...], "root": "0x..." },
    "confirmation": { "chain_block_number": 7894214 },
    "ipfs": { "cid": "bafy...", "url": "https://gateway.pinata.cloud/ipfs/bafy..." },
    "source_record": {...},
    "source_table": "work_orders"
  },
  "meta": { "has_source_record": true, "source_record_fetched_from": "work_orders" }
}

Epochs

Time-bucketed groupings of anchored batches.

GET/api/explorer/epoch/{idOrNumber}

Epoch detail: every batch in the epoch with block + tx info plus aggregate stats.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/epoch/12

Example Response

json

{
  "data": {
    "epoch": { "id": "uuid", "number": 12, "label": "Epoch 12", "started_at": "...", "ended_at": "...", "status": "closed", "merkle_root": "0x...", "batch_count": 40, "record_count": 1064 },
    "batches": [{ "id": "uuid", "merkle_root": "0x...", "record_count": 28, "tx_hash": "0x...", "block_number": 7894214, "anchored_at": "...", "etherscan_tx_url": "..." }],
    "aggregate": { "total_records": 1064, "batch_count": 40, "distinct_record_types": 9, "earliest_record_at": "...", "latest_record_at": "..." }
  },
  "meta": { "chain": "sepolia", "chain_id": 11155111, "epochs_lib_present": true }
}

Record Types

Browse audit hashes grouped by their record_type.

GET/api/explorer/types

Every distinct record_type with counts, anchored/pending split, first/last seen, and a sample display_id.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/types

Example Response

json

{
  "data": [
    {
      "record_type": "work_orders",
      "count": 4012,
      "anchored_count": 3892,
      "pending_count": 120,
      "first_seen": "2026-01-12T...",
      "last_seen":  "2026-05-19T...",
      "sample_record_id": "uuid",
      "sample_display_id": "0xWO.a1b2c3d4"
    }
  ],
  "meta": { "total_types": 11, "sampled_rows": 12847, "truncated": false }
}

GET/api/explorer/types/{recordType}

Paginated list of audit_hashes for one record type, optionally filtered by since (ISO) and anchored status.

Query Parameters

limit

integer · default 25

Number of rows (1-100).

offset

integer · default 0

Pagination offset.

since

string (ISO)

Only records created after this timestamp.

anchored

true | false

Filter to anchored or pending only.

Example Request

bash

curl "https://blockchain.myaviationtools.com/api/explorer/types/work_orders?limit=25&anchored=true"

Example Response

json

{
  "data": {
    "record_type": "work_orders",
    "total": 4012,
    "first_seen": "2026-01-12T...",
    "last_seen": "2026-05-19T...",
    "audit_hashes": [
      {
        "id": "uuid",
        "record_hash": "0x...",
        "record_id": "uuid",
        "display_id": "0xWO.a1b2c3d4",
        "ipfs_cid": "bafy...",
        "created_at": "2026-05-19T...",
        "scope_type": "aircraft",
        "scope_id": "uuid",
        "batch_id": "uuid",
        "block_number": 7894214,
        "tx_hash": "0x...",
        "anchored_at": "2026-05-19T...",
        "anchored": true
      }
    ]
  },
  "meta": { "limit": 25, "offset": 0, "has_more": true, "total": 4012, "returned_count": 25, "filters": { "since": null, "anchored": "true" } }
}

Search

Universal search across hashes, transactions, blocks, and display IDs.

GET/api/explorer/search

Resolve any user-pasted identifier — record hash, tx hash, block number, audit UUID, or display ID (e.g. 0xAC.xxxxxxxx).

Query Parameters

q *

string

The search query.

Example Request

bash

curl "https://blockchain.myaviationtools.com/api/explorer/search?q=0xAC.a1b2c3d4"

Example Response

json

{
  "data": {
    "kind": "aircraft",
    "redirect": "/explorer/aircraft/0xAC.a1b2c3d4"
  },
  "meta": { "query": "0xAC.a1b2c3d4" }
}

Aircraft

Per-aircraft on-chain history.

GET/api/explorer/aircraft/{displayId}

All audit_hashes scoped to one aircraft (by 0xAC.xxxxxxxx display ID), grouped by epoch.

Query Parameters

limit

integer · default 50

Page size (1-100).

offset

integer · default 0

Pagination offset.

Example Request

bash

curl https://blockchain.myaviationtools.com/api/explorer/aircraft/0xAC.a1b2c3d4

Example Response

json

{
  "data": {
    "aircraft": { "display_id": "0xAC.a1b2c3d4", "record_id": "uuid" },
    "summary": { "total_records": 540, "distinct_epochs": 8, "first_anchored_at": "...", "last_anchored_at": "...", "latest_block_number": 7894214, "latest_tx_hash": "0x..." },
    "epoch_breakdown": [...],
    "records": [...]
  },
  "meta": { "limit": 50, "offset": 0, "total": 540, "returned_count": 50, "has_more": true }
}