Retrieve a legal entity | Deel

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Deel Inc.",
    "phone": "+18001234567",
    "status": "active",
    "vat_id": "P051709055R",
    "address": {
      "zip": "94105",
      "city": "San Francisco",
      "state": "CA",
      "street": "123 Main St",
      "country": "US"
    },
    "country": "US",
    "cdd_status": "APPROVED",
    "created_at": "2024-01-01T12:00:00Z",
    "legal_name": "Deel Inc.",
    "legal_type": "company",
    "updated_at": "2024-01-02T12:00:00Z",
    "archived_at": "2024-01-06T12:00:00Z",
    "entity_type": "corporation",
    "industry_name": "Software Development",
    "incorporation_date": "2020-01-15",
    "registration_number": "987654321"
  }
}

Returns the full record for a single legal entity by id: registration and tax identifiers, address, industry, incorporation date and lifecycle status. cdd_status carries the raw Customer Due Diligence value (coalesced to PENDING when CDD is required, NOT_REQUIRED for Tier-0/SaaS entities before verification starts) and status the mapped lifecycle status, so integrations can poll entity clearance. Returns 404 if the id is unknown or belongs to another organization.

Token scopes: legal-entity:read

Returns the full record for a single legal entity by id: registration and tax identifiers, address, industry, incorporation date and lifecycle status. `cdd_status` carries the raw Customer Due Diligence value (coalesced to `PENDING` when CDD is required, `NOT_REQUIRED` for Tier-0/SaaS entities before verification starts) and `status` the mapped lifecycle status, so integrations can poll entity clearance. Returns 404 if the id is unknown or belongs to another organization. **Token scopes**: `legal-entity: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/

Path parameters

legal_entity_idstringRequired

The ID of the legal entity to retrieve.

Response

Successful operation.

dataobjectOptional

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'

$	curl https://api.letsdeel.com/rest/legal-entities/123e4567-e89b-12d3-a456-426614174000 \
>	-H "Authorization: Bearer <token>"