Retrieve contractor invoice and payment-status data from Deel via the Accounting API's invoice endpoints.
domain: developer.deel.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Generate a Deel API bearer token from the Deel app (or via OAuth2) scoped to include accounting:read (and worker:read for single-invoice lookups).
Call GET https://api.letsdeel.com/rest/v2/invoices with Authorization: Bearer <token> to list workforce (contractor/worker) invoices; by default only paid invoices are returned.
Pass status=all to include unpaid/overdue/draft invoices, and issued_from_date/issued_to_date to filter by issue date range.
Paginate with limit (1-50, default 25) and offset, or follow the returned page.cursor for cursor-based pagination.
Call GET https://api.letsdeel.com/rest/v2/ic/workers/invoices/{invoice_id} to retrieve full detail (status, currency, total, amount, payment_display_status) for one invoice by id.
Call GET https://api.letsdeel.com/rest/v2/ic/workers/invoices/{invoice_id}/pdf to download the source invoice document when needed.
Known gotchas
Deel has two similarly-named endpoints: /rest/v2/invoices (worker/contractor invoices) versus /rest/v2/invoices/deel (Deel's own platform-fee invoices) — calling the wrong one returns a plausible-looking but incorrect dataset, with no error.
The whole Deel organization shares one rate limit of 5 requests/second across all API tokens, on a rolling 1-second window, with no rate-limit response headers — you only learn you've hit it via HTTP 429, so build in backoff proactively.
GET /rest/v2/invoices returns only status=paid invoices by default; omitting status=all silently hides pending/overdue contractor payments from the result set.
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?