Get network status

GET/v1/status

TSCScan API v1.0.0 · Network · also at /api/v1/mainnet/status

Chain-dependent response; compact chain headers identify the serving snapshot.

Example

curl 'https://api.tensorcash.org/v1/status'

No parameters.

Status	Description	Body
`200`	Successful read from one Indexer snapshot	application/json `StatusResponse`
`400`	Invalid argument or page conditions	application/problem+json `Problem`
`401`	Authentication required	application/problem+json `Problem`
`403`	Permission denied	application/problem+json `Problem`
`404`	Absent in a ready indexed range	application/problem+json `Problem`
`409`	Verified chain continuity invalidation	application/problem+json `Problem`
`422`	Bounded response would exceed byte budget	application/problem+json `Problem`
`429`	Quota exceeded; Retry-After supplied	application/problem+json `Problem`
`503`	Data or eligible source not ready	application/problem+json `Problem`
`504`	Bounded upstream query timed out	application/problem+json `Problem`

Field	Type	Required	Description
`data`	`NetworkStatus`	Yes	The requested resource or collection; its schema is specific to this endpoint.

Field	Type	Required	Description
`network`	`"mainnet" \| "testnet"`	Yes	Network selected by this API deployment.
`observed_header_height`	`integer \| null`	Yes	Fresh Core header height. Headers ahead of blocks indicate that Core itself has not caught up, even when the Indexer matches Core.
`core_initial_block_download`	`boolean \| null`	Yes	Fresh Core initial-block-download flag. Null when unavailable; wallet clients must not assume synchronized spending.
`sync_state`	`"ready" \| "catching_up" \| "upstream_unavailable" \| "maintenance" \| "unavailable"`	Yes	Indexer state: ready, catching_up, upstream_unavailable, maintenance or unavailable. upstream_unavailable keeps the committed indexed snapshot readable while current Core height is unknown.
`observed_core_height`	`integer \| null`	Yes	Last successfully observed Core chain height; null while Core cannot be observed.
`last_core_poll_at`	`string (date-time) \| null`	Yes	UTC RFC 3339 timestamp of the last successful Core observation; null when unavailable.
`coverage`	`object`	Yes	Indexed coverage for this module or sampled chart series; incomplete data is explicit.

Field	Type	Required	Description
`state`	`"complete" \| "partial" \| "unsupported"`	Yes	Availability or confirmation state. Use the declared enum/constant; unknown or unavailable never means numeric zero.
`through_height`	`integer \| null`	Yes	Highest canonical height covered by this module; -1 means no indexed coverage.
`scope`	`"chain_wide" \| "current_state" \| "wallet_scoped" \| "none"`	Yes	Coverage scope. chain_wide means every required block from genesis through the reported height.

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.
`status`	`integer`	Yes	HTTP status code for this problem response.
`code`	`"INVALID_ARGUMENT" \| "UNAUTHORIZED" \| "FORBIDDEN" \| "RESOURCE_NOT_FOUND" \| "CHAIN_ANCHOR_INVALIDATED" \| "RATE_LIMITED" \| "DATA_NOT_READY" \| "SERVICE_UNAVAILABLE" \| "UPSTREAM_TIMEOUT" \| "RESPONSE_TOO_LARGE" \| "CORE_UNAVAILABLE" \| "CORE_METHOD_UNAVAILABLE" \| "CORE_DATA_NOT_READY" \| "CORE_CAPACITY" \| "TRANSACTION_CAPACITY" \| "TRANSACTION_STATE_CHANGED" \| "TRANSACTION_REJECTED" \| "BROADCAST_OUTCOME_UNKNOWN" \| "UNSUPPORTED_ASSET_POLICY"`	Yes	Stable machine-readable error code; use this instead of matching message text.
`request_id`	`string`	Yes	Identifier also supplied in X-Request-ID; include it when reporting an error.
`detail`	`string`	—	Human-readable explanation of the error.
`retry_after_seconds`	`integer`	—	Suggested wait in seconds before retrying; where present, agrees with Retry-After.