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.

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.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about 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