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-03-27T15:47:09.539Z",
      "updatedAt": "2026-03-27T15:47:09.539Z",
      "deletedAt": "2026-03-27T15:47:09.540Z",
      "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-03-27T15:47:09.539Z",
          "updatedAt": "2026-03-27T15:47:09.539Z",
          "deletedAt": "2026-03-27T15:47:09.540Z",
          "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

investorAccountIdstringRequired

namestring · min: 2 · max: 50Required

einstring · min: 9 · max: 9Optional

emailstring · emailOptionalExample: [email protected]

companyTypestring · min: 2 · max: 50Optional

phonestring · nullableOptionalExample: [phone]

dateOfIncorporationany · nullableOptional

stateOfIncorporationstring · enumOptionalExample: CAPossible values:

addressstring · min: 2 · nullableOptional

address2string · nullableOptional

citystring · min: 2 · max: 30 · nullableOptional

countrystring · enum · nullableOptionalPossible values:

statestring · nullableOptional

zipstring · nullableOptional

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: 277

{
  "investorAccountId": "text",
  "name": "text",
  "ein": "text",
  "email": "[email protected]",
  "companyType": "text",
  "phone": "[phone]",
  "dateOfIncorporation": null,
  "stateOfIncorporation": "CA",
  "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-04-03T19:53:16.017Z",
  "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

idstringRequiredExample: entityprefix_01j1xgme5qeqq97gpdztd7e4a6

__entitystringOptionalExample: Entity

createdAtone ofRequiredExample: 2026-03-27T15:47:09.539Z

string · date-timeOptional

or

string · date-timeOptional

updatedAtone ofRequiredExample: 2026-03-27T15:47:09.539Z

string · date-timeOptional

or

string · date-timeOptional

deletedAtone of · nullableRequiredExample: 2026-03-27T15:47:09.540Z

string · date-timeOptional

or

string · date-timeOptional

thirdPartyIdstring · nullableRequiredExample: third_party_legal_entity_123

accountIdstringRequiredExample: account_01j1xgme5qeqq97gpdztd7e4a6

investorAccountIdstringRequiredExample: investor_account_01j1xgme5qeqq97gpdztd7e4a7

kybStatusanyRequiredExample: PENDING

sanctionsStatusanyRequiredExample: PENDING

namestringRequiredExample: Acme Corporation

einstring · nullableOptionalExample: 12-3456789

companyTypestring · nullableOptionalExample: LLC

streetAddressstring · nullableOptionalExample: 123 Main St

citystring · nullableOptionalExample: Anytown

statestring · nullableRequiredExample: CA

zipstring · nullableOptionalExample: 12345

countrystring · nullableOptionalExample: USA

phonestring · nullableOptionalExample: [phone]

setupStatusstring · enumRequiredPossible values:

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-03-27T15:47:09.539Z",
  "updatedAt": "2026-03-27T15:47:09.539Z",
  "deletedAt": "2026-03-27T15:47:09.540Z",
  "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-03-27T15:47:09.539Z",
      "updatedAt": "2026-03-27T15:47:09.539Z",
      "deletedAt": "2026-03-27T15:47:09.540Z",
      "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

idstringOptional

namestring · min: 2 · max: 50Optional

einstring · min: 9 · max: 9Optional

emailstring · emailOptionalExample: [email protected]

companyTypestring · min: 2 · max: 50Optional

phonestring · nullableOptionalExample: [phone]

dateOfIncorporationany · nullableOptional

stateOfIncorporationstringOptional

addressstring · min: 2 · nullableOptional

address2string · nullableOptional

citystring · min: 2 · max: 30 · nullableOptional

countrystring · enum · nullableOptionalPossible values:

statestring · nullableOptional

zipstring · nullableOptional

Responses

200

200

application/json

idstringRequired

accountIdstringRequired

investorAccountIdstringRequired

namestring · min: 2 · max: 50Required

einstring · min: 9 · max: 9 · nullableOptional

emailstring · email · nullableRequired

companyTypestring · nullableRequired

addressstring · nullableRequired

address2string · nullableRequired

citystring · nullableRequired

statestring · nullableRequired

zipstring · nullableRequired

countrystring · nullableRequired

phonestring · nullableRequired

dateOfIncorporationstring · date-time · nullableRequired

stateOfIncorporationstring · nullableRequired

setupStatusstring · enumRequiredPossible values:

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-04-03T19:53:16.017Z",
  "stateOfIncorporation": "text",
  "setupStatus": "IN_PROGRESS"
}