REST API Pagination

All list endpoints support standard cursor-based pagination.

bash

# First page
curl "$API/govchain/procurement/v1/process?pagination.limit=10"

# Next page (use next_key from previous response)
curl "$API/govchain/procurement/v1/process?pagination.limit=10&pagination.key=<next_key>"

# Reverse order (newest first)
curl "$API/govchain/procurement/v1/process?pagination.limit=10&pagination.reverse=true"

# Count total (slower -- adds query overhead)
curl "$API/govchain/procurement/v1/process?pagination.count_total=true"

# Offset-based alternative
curl "$API/govchain/procurement/v1/process?pagination.offset=20&pagination.limit=10"

Response pagination block:

json

{
  "pagination": {
    "next_key": "base64-encoded-key-or-null",
    "total": "0"
  }
}

total is only populated when count_total=true.