For each target country, retrieve the local hiring guide and required tax configuration fields via GET /rest/v2/eor/validations/{country_code}
During contract creation, include the required tax fields for the worker's country (e.g., tax identification numbers, residency declarations, applicable tax treaty claims)
After contract activation, use the payslip API to verify that the correct tax regime is applied: GET /rest/v2/eor/workers/{worker_id}/payslips and inspect tax line items
For countries where Deel requires employer tax registration, follow the in-platform compliance workflow — the API alone does not initiate entity registration
When a worker's tax situation changes (e.g., change of residency, tax treaty election), update the contract via the appropriate Deel endpoint and obtain a new signed contract
Retain payslip records with tax breakdowns for a minimum period consistent with each country's statutory records retention requirements
Known gotchas
Tax rules vary significantly by country and can change mid-year; Deel manages local tax compliance on the employer side as part of the EOR service, but the employer must provide accurate employee data — garbage-in produces incorrect withholding
Some countries require employer-specific registrations or mandatory contributions (e.g., social insurance, pension schemes) that cannot be configured purely via API; these require Deel's in-platform setup before API use
Payslip tax line item labels differ by country; do not parse payslip data by fixed field position — use the labeled fields returned in the API response JSON
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp