Pagination

The current pagination contract is:

• offset pagination by default
• cursor pagination only when you pass pagination=cursor

Offset Pagination

Use these query parameters for the default mode:

• limit
• offset

Example:

curl "https://api.conduitt.io/clients?limit=25&offset=0" \
  -H "Authorization: Bearer ck_test_your_key"

Cursor Pagination

Opt in with pagination=cursor, then use:

• first
• last
• after
• before
• orderBy
• orderDirection

Example:

curl "https://api.conduitt.io/invoices?pagination=cursor&first=20&orderDirection=desc" \
  -H "Authorization: Bearer ck_test_your_key"

Cursor Response Shape

Cursor responses include:

• edges
• pageInfo
• totalCount

The server also includes a Link header for cursor navigation metadata.

Guidance

• use offset mode for simple admin and reporting pages
• use cursor mode when you need stable traversal over larger changing datasets
• do not mix older starting_after and ending_before examples from stale docs with Corinthian’s current cursor parameters