Fetch multiple EOR Contract forms | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/forms/eor/create-contract/definitions"
querystring = {"limit":"5","cursor":"eyJvZmZzZXQiOjEwfQ=="}
payload = { "data": { "countries": [{
                "country_code": "US",
                "state": "CA"
            }, { "country_code": "BR" }] } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers, params=querystring)
print(response.json())

{
  "data": [
    {
      "pages": [
        {
          "title": "Personal Details",
          "sections": [
            {
              "title": "Team information",
              "questions": [
                {
                  "key": "client.legal_entity.id",
                  "type": "Dropdown",
                  "title": "Legal entity ID",
                  "rules": [
                    {
                      "title": "Legal entity ID",
                      "source": {
                        "url": "/rest/v2/legal-entities",
                        "definition": "https://developer.deel.com/reference/getlegalentitylist",
                        "description": "Available legal entities for selection must be dynamically fetched"
                      },
                      "options": [
                        {
                          "title": "Yes",
                          "value": "true"
                        },
                        {
                          "title": "No",
                          "value": "false"
                        }
                      ],
                      "is_range": false,
                      "requires": [
                        {
                          "key": "employee.nationality",
                          "value": true,
                          "operator": "ne",
                          "compare_key": "employment.country"
                        }
                      ],
                      "max_value": 180,
                      "min_value": 0,
                      "max_length": 255,
                      "min_length": 1,
                      "helper_text": "Please select the appropriate legal entity.",
                      "is_disabled": false,
                      "is_required": true,
                      "number_type": "CURRENCY",
                      "default_value": 40,
                      "is_only_digits": false,
                      "date_limitation": "BLOCK_PAST",
                      "is_multiple_selection": false,
                      "must_request_validation": true
                    }
                  ],
                  "source": {
                    "url": "/rest/v2/legal-entities",
                    "definition": "https://developer.deel.com/reference/getlegalentitylist",
                    "description": "Available legal entities for selection must be dynamically fetched"
                  },
                  "options": [
                    {
                      "title": "Yes",
                      "value": "true"
                    },
                    {
                      "title": "No",
                      "value": "false"
                    }
                  ],
                  "is_range": false,
                  "max_value": 180,
                  "min_value": 0,
                  "max_length": 255,
                  "min_length": 1,
                  "helper_text": "Please select the appropriate legal entity.",
                  "is_disabled": false,
                  "is_required": true,
                  "number_type": "CURRENCY",
                  "default_value": 40,
                  "is_only_digits": false,
                  "date_limitation": "BLOCK_PAST",
                  "is_multiple_selection": false,
                  "must_request_validation": true
                }
              ],
              "subtitle": "Information about the team"
            }
          ]
        }
      ],
      "country": "US",
      "state": "CA"
    }
  ],
  "has_more": true,
  "total_count": 25,
  "next_cursor": "eyJvZmZzZXQiOjEwfQ=="
}

Retrieve paginated, versioned form definitions for creating EOR contracts for the specified countries. Use this endpoint when initializing or resuming a contract-creation flow to determine the required sections, fields, validation rules, and conditional logic per country (and optional contract type/locale). Always consume the latest effective version from the response and handle pagination. Not intended for reading or updating existing contracts. Token scopes: forms:read

Authentication

AuthorizationBearer

Authentication

Deel API uses API tokens to authenticate requests. A bearer token is required to authenticate all API requests. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. curl -X GET 'api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE'

## Authentication Deel API uses API tokens to authenticate requests. A bearer token is required to authenticate all API requests. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. ``` curl -X GET 'api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` ### Generating Access Tokens 1. Navigate to **Apps & Perks > Developer Center**. 2. Click on the “Generate New Token” button. 3. In the popup, click “Generate Token” button to generate a new token. Your newly generated token is visible on the screen. 4. Make sure to copy and save your token once is generated. You won't be able to see it again!

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

limitintegerOptional1-10Defaults to 10

Maximum number of countries to return in a single response. Defaults to 10.

cursorstringOptional

Pagination cursor for fetching subsequent pages of results.

Request

Request body containing countries and optional parameters for bulk quote form fetching.

dataobjectRequired

Response

Successful response containing multiple form configuration data.

datalist of objects

Array of quote forms for the requested countries.

has_moreboolean

Indicates if there are more results available beyond the current page.

total_countinteger

Total number of countries in the request.

next_cursorstring or null

Cursor for fetching the next page of results. Null if no more results.

Authentication

Authentication

Query parameters

Request

Response

Errors

Authentication