Authenticate requests and paginate through list endpoints in the Fleetio API
domain: developer.fleetio.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Generate an API key from Account Settings > Manage API Keys, and note the Account-Token shown at the bottom of that same page.
Include an Authorization header formatted as "Token " followed by the API key (the literal word Token, then a space, then the key) on every request.
Include an Account-Token header set to your account's token on every request — both headers are required together.
On newer index endpoints (API versions 2024-01-01 and later), paginate using the start_cursor and per_page query parameters, then read next_cursor from the response to fetch the next page instead of assuming a fixed page count.
On older index endpoints, paginate using the page query parameter (starting at 1) and consult the X-Pagination-Total-Pages and X-Pagination-Current-Page response headers to know when to stop.
Known gotchas
Cursor-paginated endpoints return an object with a records array plus pagination/filter/sort metadata rather than a bare array, and they no longer return the old X-Pagination-* headers.
Exceeding your plan's rate limit returns HTTP 429 with a Retry-After header telling you how many seconds to wait before retrying.
Default and maximum page sizes differ by pagination style (cursor endpoints default to 50 and cap per_page at 100; older endpoints default per to 100), so don't hardcode an expected page size.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?