network.bsky.jetstream.listSegments

Enumerate sealed segment files available for download, in ascending index order.

Repository @bsky-lexicons.bsky.social did:plc:4v4y5r3lwsbtmsxhile2ljac namespace authority

Details · query

Kind	query
Authority	jetstream.bsky.network
Indexed	87d ago · 2026-08-15

Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

cursor

string

Opaque pagination cursor from a previous response.

limit

integer

Maximum number of segment file names to return.

minimum: 1
maximum: 1000
default: 100

Output

application/json

cursor

string

segments

requiredarray

itemsref

Reference

#segment

#segment

object

Properties

checksum

requiredstring

Segment-format xxh3 metadata checksum as 16-char hex; equals the getSegment ETag.

eventCount

requiredinteger

Number of events in the segment.

index

requiredinteger

Zero-based segment index.

maxSeq

requiredinteger

maxWitnessedAt

requiredinteger

Latest witnessed-at, unix microseconds.

minSeq

requiredinteger

minWitnessedAt

requiredinteger

Earliest witnessed-at, unix microseconds.

name

requiredstring

Segment filename; pass to getSegment.

sizeBytes

requiredinteger

File size in bytes.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

network.bsky.jetstream.getSegment
query

Download a sealed segment file by name.
network.bsky.jetstream.planSnapshot
procedure

Build a download plan for the desired data pattern. The plan lists whole segments or block ranges that might contain events for the requested kinds, DIDs, and collections.