List of legal entities | Deel

curl -G https://api.letsdeel.com/rest/legal-entities \
     -H "Authorization: Bearer <token>" \
     -d limit=100 \
     -d sort_order=ASC \
     -d cursor=cusorpage123 \
     -d include_archived=true \
     -d legal_entity_id=23378 \
     -d global_payroll=false \
     -d type=company \
     -d country=US \
     -d include_payroll_settings=true

{
  "data": [
    {
      "id": "b61f6b35-7670-4515-b667-066f02b7b8a0",
      "name": "Deel US",
      "phone": "+137867888",
      "vat_id": "P051709055R",
      "address": {
        "zip": "12345",
        "city": "San Francisco",
        "state": "Texas",
        "street": "123 Main St",
        "country": "US"
      },
      "country": "US",
      "created_at": "2024-01-01T12:00:00Z",
      "sic_number": "9072",
      "updated_at": "2024-01-02T12:00:00Z",
      "archived_at": "2024-01-06T12:00:00Z",
      "entity_type": "company",
      "industry_name": "Marketing Agency",
      "entity_subtype": "company",
      "registrationNumber": "GSUGO3B5"
    }
  ],
  "page": {
    "cursor": "cursor123"
  }
}

Lists the legal entities under the calling organization so an integration can resolve which entity a worker, contract, payroll cycle or invoice belongs to; the ids returned are the legal entity ids other Deel endpoints expect. Filter by country, type, global_payroll or legal_entity_id, and set include_payroll_settings to include payroll config in the same call. Archived entities are returned by default — pass include_archived=false for active only. Results are cursor-paginated.

Token scopes: organizations:read, accounting:read

Lists the legal entities under the calling organization so an integration can resolve which entity a worker, contract, payroll cycle or invoice belongs to; the ids returned are the legal entity ids other Deel endpoints expect. Filter by `country`, `type`, `global_payroll` or `legal_entity_id`, and set `include_payroll_settings` to include payroll config in the same call. Archived entities are returned by default — pass `include_archived=false` for active only. Results are cursor-paginated. **Token scopes**: `organizations:read`, `accounting: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.

$ curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -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.deel.training/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-100Defaults to 100

The number of results to return per page.

sort_orderenumOptionalDefaults to ASC

Sorting order of the results.

Allowed values:

cursorstringOptional

Cursor for pagination.

include_archivedbooleanOptionalDefaults to true

Whether to include archived legal entities in the results.

legal_entity_idstringOptional

Filter by specific legal entity ID.

global_payrollbooleanOptional

Filter by global payroll flag.

typestringOptional

Filter by entity type.

countrystringOptional

Filter by country.

include_payroll_settingsbooleanOptional

Whether to include payroll settings in the response.

Response

Successful operation.

datalist of objectsOptional

pageobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'