LegalEntities

Get legalEntities

get

Authorizations

api_key

X-API-KEYstringRequired

Query parameters

pagenumber · nullableOptionalDefault: 1

limitnumber · nullableOptionalDefault: 10

kybStatusstring · enumOptionalPossible values:

sanctionsStatusstring · enumOptionalPossible values:

includestringOptionalExample: kybs

Responses

200

200

application/json

401

401

application/json

403

403

application/json

get

/clients/api/v1/legal-entities/

HTTPcURLJavaScriptPython

GET /clients/api/v1/legal-entities/ HTTP/1.1
Host: platform.dalmoregroup.com
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": "entityprefix_01j1xgme5qeqq97gpdztd7e4a6",
      "__entity": "Entity",
      "createdAt": "2026-02-02T18:26:08.573Z",
      "updatedAt": "2026-02-02T18:26:08.573Z",
      "deletedAt": "2026-02-02T18:26:08.574Z",
      "thirdPartyId": "third_party_legal_entity_123",
      "accountId": "account_01j1xgme5qeqq97gpdztd7e4a6",
      "investorAccountId": "investor_account_01j1xgme5qeqq97gpdztd7e4a7",
      "kybStatus": "PENDING",
      "sanctionsStatus": "PENDING",
      "kybs": [
        {
          "id": "entityprefix_01j1xgme5qeqq97gpdztd7e4a6",
          "__entity": "Entity",
          "createdAt": "2026-02-02T18:26:08.573Z",
          "updatedAt": "2026-02-02T18:26:08.573Z",
          "deletedAt": "2026-02-02T18:26:08.574Z",
          "thirdPartyId": "third_party_kyb_123",
          "platform": "KYB Platform",
          "legalEntityId": "legal_entity_01j1xgme5qeqq97gpdztd7e4a6",
          "documentType": "Certificate of Incorporation",
          "documentImage": "https://example.com/document.pdf",
          "kybStatus": "PENDING",
          "reason": "Additional information required",
          "response": "Submitted additional documents"
        }
      ],
      "name": "Acme Corporation",
      "ein": "12-3456789",
      "companyType": "LLC",
      "streetAddress": "123 Main St",
      "city": "Anytown",
      "state": "CA",
      "zip": "12345",
      "country": "USA",
      "phone": "[phone]",
      "setupStatus": "IN_PROGRESS"
    }
  ],
  "meta": {
    "itemCount": 1,
    "totalItems": 10,
    "itemsPerPage": 1,
    "totalPages": 10,
    "currentPage": 1
  }
}

Create Legal Entity

post

Authorizations

api_key

X-API-KEYstringRequired

Body

application/json

Responses

201

201

application/json

401

401

application/json

403

403

application/json

404

404

application/json

post

/clients/api/v1/legal-entities/

HTTPcURLJavaScriptPython

POST /clients/api/v1/legal-entities/ HTTP/1.1
Host: platform.dalmoregroup.com
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 279

{
  "investorAccountId": "text",
  "name": "text",
  "ein": "text",
  "email": "[email protected]",
  "companyType": "text",
  "phone": "[phone]",
  "dateOfIncorporation": null,
  "stateOfIncorporation": "text",
  "address": "text",
  "address2": "text",
  "city": "text",
  "country": "AD",
  "state": "text",
  "zip": "text"
}

{
  "id": "text",
  "accountId": "text",
  "investorAccountId": "text",
  "name": "text",
  "ein": "text",
  "email": "[email protected]",
  "companyType": "text",
  "address": "text",
  "address2": "text",
  "city": "text",
  "state": "text",
  "zip": "text",
  "country": "text",
  "phone": "text",
  "dateOfIncorporation": "2026-02-03T16:40:00.142Z",
  "stateOfIncorporation": "text",
  "setupStatus": "IN_PROGRESS"
}

Get legalEntity by id

get

Authorizations

api_key

X-API-KEYstringRequired

Path parameters

idstringRequired

Query parameters

includestringOptionalExample: kybs

Responses

200

200

application/json

401

401

application/json

403

403

application/json

404

404

application/json

get

/clients/api/v1/legal-entities/{id}

HTTPcURLJavaScriptPython

GET /clients/api/v1/legal-entities/{id} HTTP/1.1
Host: platform.dalmoregroup.com
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": "entityprefix_01j1xgme5qeqq97gpdztd7e4a6",
  "__entity": "Entity",
  "createdAt": "2026-02-02T18:26:08.573Z",
  "updatedAt": "2026-02-02T18:26:08.573Z",
  "deletedAt": "2026-02-02T18:26:08.574Z",
  "thirdPartyId": "third_party_legal_entity_123",
  "accountId": "account_01j1xgme5qeqq97gpdztd7e4a6",
  "investorAccountId": "investor_account_01j1xgme5qeqq97gpdztd7e4a7",
  "kybStatus": "PENDING",
  "sanctionsStatus": "PENDING",
  "kybs": [
    {
      "id": "entityprefix_01j1xgme5qeqq97gpdztd7e4a6",
      "__entity": "Entity",
      "createdAt": "2026-02-02T18:26:08.573Z",
      "updatedAt": "2026-02-02T18:26:08.573Z",
      "deletedAt": "2026-02-02T18:26:08.574Z",
      "thirdPartyId": "third_party_kyb_123",
      "platform": "KYB Platform",
      "legalEntityId": "legal_entity_01j1xgme5qeqq97gpdztd7e4a6",
      "documentType": "Certificate of Incorporation",
      "documentImage": "https://example.com/document.pdf",
      "kybStatus": "PENDING",
      "reason": "Additional information required",
      "response": "Submitted additional documents"
    }
  ],
  "name": "Acme Corporation",
  "ein": "12-3456789",
  "companyType": "LLC",
  "streetAddress": "123 Main St",
  "city": "Anytown",
  "state": "CA",
  "zip": "12345",
  "country": "USA",
  "phone": "[phone]",
  "setupStatus": "IN_PROGRESS"
}

Update Legal Entity

patch

Authorizations

api_key

X-API-KEYstringRequired

Path parameters

idstringRequired

Body

application/json

Responses

200

200

application/json

401

401

application/json

403

403

application/json

404

404

application/json

patch

/clients/api/v1/legal-entities/{id}

HTTPcURLJavaScriptPython

PATCH /clients/api/v1/legal-entities/{id} HTTP/1.1
Host: platform.dalmoregroup.com
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 264

{
  "id": "text",
  "name": "text",
  "ein": "text",
  "email": "[email protected]",
  "companyType": "text",
  "phone": "[phone]",
  "dateOfIncorporation": null,
  "stateOfIncorporation": "text",
  "address": "text",
  "address2": "text",
  "city": "text",
  "country": "AD",
  "state": "text",
  "zip": "text"
}

{
  "id": "text",
  "accountId": "text",
  "investorAccountId": "text",
  "name": "text",
  "ein": "text",
  "email": "[email protected]",
  "companyType": "text",
  "address": "text",
  "address2": "text",
  "city": "text",
  "state": "text",
  "zip": "text",
  "country": "text",
  "phone": "text",
  "dateOfIncorporation": "2026-02-03T16:40:00.142Z",
  "stateOfIncorporation": "text",
  "setupStatus": "IN_PROGRESS"
}