Leaders

Get leader capability by object ID

Required API-key scope: leaders:read.

get /leaders/{leader_cap_id}

Authorizations

x-api-key string header required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Path Parameters

leader_cap_id string required

Leader capability object id

200application/json

Leader capability detail

claim_token string | null
claimed_tx_digest string | null
created_at string required
created_tx_digest string required

The first transaction the projection saw for this cap — the creation transaction only if the projection saw it; a projection started mid-lineage records whichever status or stake event arrived first.

is_founding boolean required
issued_tx_digest string | null
leader_address string | null
leader_cap_id string required
network_object_id string | null

Null while the leader is known only from a LeaderUpserted or StakeDeposited that arrived ahead of its LeaderCapIssued, which is the only event carrying the network object.

onchain_created_at string | null

Checkpoint timestamp of the on-chain creation event; null for rows projected before on-chain timestamps were indexed (until a backfill + replay fills them).

registry_object_id string | null
stake_pool_total integer<int64> required

US currently pooled behind this leader, and the shares outstanding against it. Both are running aggregates over the stake ledger, so they are only complete if the projection saw the leader's whole history; GET /leaders/{leader_cap_id}/stake-events is the source of truth.

stake_total_shares integer<int64> required
status string | null

active, suspended or slashed. Null until a LeaderUpserted or LeaderStatusChanged names the state — a founding cap exists before either.

updated_at string required

404

Leader capability was not found

500

Internal server error