Skip to main content
GET
Track By Number
Resolves a track by position: give it a tape and a track number, get the same catalog record that track metadata returns by address. Track numbers are positions in the tape’s Merkle tree, assigned in write order and never reused. That makes them a stable way to walk a tape from front to back: start at zero, count up, and every number below the tape’s track count resolves to exactly one record. It’s the natural endpoint for indexers and backup tools that process a tape in order and don’t want to collect addresses first. The response arrives in the SDK’s binary encoding, so use an SDK method rather than curl (conventions). From Rust, get_track_by_number resolves the same record from chain state (Rust SDK).