API Idempotency & EOR Contract Forms

Idempotent Requests

We’re introducing idempotency keys to make the Deel API safer and more reliable — especially for sensitive operations like contract creation and payments.

Why it matters
Third-party systems often retry failed requests. Without idempotency, this can lead to duplicate operations. Idempotency keys solve this by ensuring the same request won’t be processed twice.

How it works

• Send an idempotency-key header with your API request.
• If the same key is used within 24 hours, the API returns the original response.
• No duplicate processing, no unintended side effects.

➡️ Learn more about idempotency

Forms

Get EOR Contract Form

Dynamically generate the correct contract form for any country without hardcoding the logic in your frontend. EOR contract requirements vary by country—fields, defaults, legal constraints—so this endpoint ensures your app always reflects the latest, compliant structure for that country. It decouples logic from your codebase and lets Deel handle country-specific rules centrally.

Method: GET

Endpoint: /rest/v2/forms/eor/create-contract/{country_code}

Docs: View on Developer Portal

Example Request

curl --request GET \
     --url https://api.letsdeel.com/rest/v2/forms/eor/create-contract/{country_code}/gb \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {YOUR_TOKEN}'