Fetch multiple EOR Contract forms | Deel

curl -X POST "https://api.letsdeel.com/rest/v2/forms/eor/create-contract/definitions?limit=5&cursor=eyJvZmZzZXQiOjEwfQ" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": {
    "countries": [
      {
        "country_code": "US",
        "state": "CA"
      },
      {
        "country_code": "BR"
      }
    ]
  }
}'

{
  "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

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

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.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'