TSCScan API v1.0.0 · Transactions · also at /api/v1/mainnet/transactions/{txid}/status
Indexed confirmed transactions reuse compact inclusion metadata for at most 300 seconds within configured cache budgets; confirmations are derived from the latest verified indexed checkpoint identified by optional X-Chain-Height/X-Chain-Hash headers. After a rollback, reuse requires the inclusion height to survive every intervening bounded rollback fence; fork suffixes, missing/pruned history, rebuild gaps, restart/routing changes and unhealthy probes revoke reuse. Read-only requests may wait within the configured original-request recovery grace; mutations are never retried. An indexed miss falls back to live Core mempool then confirmed txindex without waiting for indexing; Core results omit indexed chain headers and are cached at most 500 ms. Core failure, blocks behind known headers, initial block download or unsynchronized txindex returns 503, never false not_found.
Confirmed inclusion at a verified indexed checkpoint, or live Core observation for unindexed/pending/unknown transactions. not_found requires synchronized Core txindex and does not prove the transaction never existed.
confirmations
integer
Yes
Confirmations at X-Chain-Height when indexed chain headers are present; otherwise the live Core observation. Zero if pending/not found. Indexed counts never use an unverified observed Core height.
block
object | null
Yes
Confirmed block. Null when unavailable.
mempool_time
integer | null
Yes
Core mempool entry time in Unix seconds. Null when unavailable.
observed_at_unix
integer
Yes
Status projection/observation time in Unix seconds. Core observations may be reused for at most 500 ms; indexed confirmation counts are derived from the current verified checkpoint.
Problem
Field
Type
Required
Description
type
string
Yes
Problem type URI; about:blank is used for the current error family.
title
string
Yes
Short human-readable problem title, normally the stable error code.