Pagination

Every collection endpoint returns the same paginated envelope, so you can write one helper and reuse it everywhere.

Request parameters

curl "https://api.materialtransition.com/v1/suppliers?page=2&per_page=10" \
  -H "Authorization: Bearer mt_demo_1234567890abcdef1234567890abcdef"

Response envelope

data holds the page of results; total is the full unpaginated count; stats (when present) carries lightweight aggregates so you avoid a second round-trip.

{
  "data": [ /* ...10 suppliers... */ ],
  "total": 48,
  "page": 2,
  "per_page": 10,
  "stats": { "verified": 31 }
}

Iterating all pages

Keep requesting until page * per_page >= total.