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=false \
     -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-15T09:30:00Z",
      "entity_type": "company",
      "industry_name": "Marketing Agency",
      "entity_subtype": "company",
      "registrationNumber": "GSUGO3B5"
    }
  ],
  "page": {
    "cursor": "cursor123"
  }
}

Returns a paginated list of legal entities in the account, with optional filtering by country, entity type, global payroll flag, and archived status. 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.letsdeel.com/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.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-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 objects

pageobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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