Entities API

Create and manage corporate entities

Entities represent corporate structures like companies, foundations, and trusts. Use these endpoints to create new entities, retrieve their details, and update their information.

Entity Object

{
  "id": "ent_abc123",
  "name": "Acme Holdings LLC",
  "status": "pre_incorporation",
  "jurisdiction_product_id": "jp_xyz789",
  "jurisdiction": {
    "id": "jur_uae",
    "name": "UAE",
    "slug": "uae"
  },
  "product": {
    "id": "prod_freezone",
    "name": "Freezone Company",
    "slug": "freezone-company"
  },
  "metadata": {
    "source": "api",
    "api_key_id": "key_abc123"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Entity Statuses

Status	Description
`pre_incorporation`	Entity created, awaiting documents and processing
`pending_kyc`	KYC verification in progress
`in_progress`	Incorporation is being processed
`active`	Entity is fully incorporated and active
`dissolved`	Entity has been dissolved

Entity Object

Entity Statuses

Endpoints