---
title: Legal Entities
description: "GET https://api.icomplykyc.com/api/v2/entities?type=legal-entities Retrieve a list of Legal Entities associated with your account limit Int Defines how many entities to return. Max value: 100. Default"
---

[Skip to content](https://support.icomplyis.com/legal-entities#main-content)

English

Show submenu for translations

[More support](https://support.icomplyis.com/kb-tickets/new?hsLang=en) [Sign in](https://support.icomplyis.com/_hcms/mem/login?redirect_url=https%3A%2F%2Fsupport.icomplyis.com%2Flegal-entities&hsLang=en)

![iComply Logo Square.jpg\]](https://support.icomplyis.com/hs-fs/hubfs/iComply%20Logo%20Square.jpg?height=40&name=iComply%20Logo%20Square.jpg)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [More support](https://support.icomplyis.com/kb-tickets/new)
- [Sign in](https://support.icomplyis.com/_hcms/mem/login?redirect_url=https%3A%2F%2Fsupport.icomplyis.com%2Flegal-entities)
- [Platform Login](https://kyc.icomplykyc.com/auth/login)

[Platform Login](https://kyc.icomplykyc.com/auth/login)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [iComply Knowledge Base](https://support.icomplyis.com/?hsLang=en)
2. [iComply API Documentation](https://support.icomplyis.com/icomply-api-documentation?hsLang=en)
3. [API Reference](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#api-reference)

- [Quick Start Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#main-content)
  
  
  
  
  
    - [Admin User Setup Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#admin-user-setup-guide)
    - [Portal Setup Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#portal-setup-guide)
    - [Platform User Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#platform-user-guide)
- [Product Documentation](https://support.icomplyis.com/product-documentation?hsLang=en#main-content)
  
  
  
  
  
    - [General](https://support.icomplyis.com/product-documentation?hsLang=en#general)
    - [Platform Overview](https://support.icomplyis.com/product-documentation?hsLang=en#platform-overview)
    - [KYC Module](https://support.icomplyis.com/product-documentation?hsLang=en#kyc-module)
    - [KYB Module](https://support.icomplyis.com/product-documentation?hsLang=en#kyb-module)
    - [AML Module](https://support.icomplyis.com/product-documentation?hsLang=en#aml-module)
    - [Administration](https://support.icomplyis.com/product-documentation?hsLang=en#administration)
    - [Portals](https://support.icomplyis.com/product-documentation?hsLang=en#portals)
    - [Troubleshoot](https://support.icomplyis.com/product-documentation?hsLang=en#troubleshoot)
    - [FAQ](https://support.icomplyis.com/product-documentation?hsLang=en#faq)
    - [Compliance](https://support.icomplyis.com/product-documentation?hsLang=en#compliance)
    - [Release Notes](https://support.icomplyis.com/product-documentation?hsLang=en#release-notes)
- [iComply API Documentation](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#main-content)
  
  
  
  
  
    - [API Reference](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#api-reference)
- [FAQs](https://support.icomplyis.com/faqs?hsLang=en#main-content)
  
  
  
  
  
    - [Product](https://support.icomplyis.com/faqs?hsLang=en#product)

# Legal Entities

Retrieve a List of All Legal Entities Associated with Your Account

`GET` `https://api.icomplykyc.com/api/v2/entities?type=legal-entities`

Retrieve a list of Legal Entities associated with your account

**Query Parameters**

| Name | Type | Description |
| --- | --- | --- |
| limit | Int | Defines how many entities to return. Max value: 100. Default value: 10 |
| type | String | Defines entity type. Expected values: all, natural-persons, legal-entities. Default value: all |
| start | Int | Defines how many entities to jump over. Default value: 0 |
| descending | Boolean | Defines whether to sort entities in ascending or descending. |
| supportingDocuments | Boolean | Specify whether to return supporting documents for the legal entity. |
| corporateVerification | Boolean | Specify whether to return verification information for this Legal Entity. |

201

 

```
{    "code": 200,    "status": "success",    "message": "",    "data": [        {            "id": "d9c66022-d01b-44f2-8ff4-7d4369923668",            "type": "Legal Entity",            "corporateInformation": {                "companyName": "New Company",                "registrationNumber": "111112",                "dateofIncorporation": "2019-01-02",                "duns": "000000",                "glei": "000000",                "companyPhone": null,                "email": "andrew@testing.com",                "primaryAddress": "123 Fake st",                "city": "Fake City",                "stateProvince": "Beograd",                "country": "CA",                "postalCode": "87333"            }        },        {            "id": "6b3g0d25-6f21-449e-af04-bbeber35fbe9",            "type": "Legal Entity",            "corporateInformation": {                "companyName": "Test Inc.",                "registrationNumber": "123456678",                "dateofIncorporation": null,                "duns": "3423489234",                "glei": "665557778",                "companyPhone": "6045559999",                "email": "matt@macbook.com",                "primaryAddress": "Guran 444",                "city": "Ruege",                "stateProvince": "French Southern Territories",                "country": "CA",                "postalCode": "787645"            },            "corporateVerifications": [                {                    "id": "a9bee36a-7f3b-4c8f-a4dd-6aa15bda5dfe",                    "legalEntityVerification": true,                    "verificationStatus": "Accepted",                    "verificationDate": "2022-01-28",                    "verificationSource": "Manual Entry",                    "businessStatement": "Doing a new demo",                    "nextReviewDate": "2023-01-28",                    "verificationIssues": []                }            ],            "supportingDocuments": []        }    ]}
```

400: Bad Request and 401: Unauthorized

```
{    // Response}
```

 

**GetLegalEntityByEntityID**

`GET` `https://api.icomplykyc.com/api/v2/entities/legal-entities/:id`

Get the details of the legal entity record by its entity ID

**Authentication Type:** Api Key

**Sample Query:** [https://api.icomplykyc.com/api/v2](https://api.icomplykyc.com/api/v2)/legal-entities/12e34567-fcff-4c10-9dd3-da74422e1c30

 

**Path Parameters**

| Name | Type | Description |
| --- | --- | --- |
| id | String | The ID of the legal entity |

200: OK

```
{    "code": 200,    "status": "success",    "message": "",    "data": {        "kybMetaData": {            "entityID": "1234567d-0e47-4079-8b01-353af8b0ef33",            "createdDateTime": "2020-12-04",            "lastUpdate": null,            "nextKYCReview": "2022-12-04",            "kycStatus": "New",            "externalID": "Starbucks555",            "tags": []        },        "corporateInformation": {            "companyName": "Starbucks Coffee Company",            "alsoKnownAs": [                "Starbucks",                "Starbucks Coffee"            ],            "doingBusinessAs": "Starbucks|Starbucks Coffee",            "formerlyKnownAs": [                "Seattle's Starbucks"            ],            "registrationNumber": "1234-3456-980",            "dateofIncorporation": "1971-03-30",            "jurisdictionOfIncorporation": "USA",            "jurisdictionOfDomicile": "USA",            "jurisdictionOfTaxResidence": "CYM",            "duns": "150483782",            "glei": "5299019D9BIL4D4UHT93",            "companyPhone": "555-242-0123",            "email": "777 Columbia St",            "primaryAddress": "777 Columbia St",            "city": "New Westminster",            "stateProvince": null,            "country": "CAN",            "postalCode": "V3M 1B6",            "linkedEntities": [                {                    "relationship": "Officer",                    "entityID": "04831052-235e-4de5-be35-eb9c4ddb33e4"                },                {                    "relationship": "Advisor",                    "entityID": "018cf32c-f4bc-4217-a797-493b729a3ae9"                }            ],            "primaryContactId": "079e0b23-d084-413d-afd2-a215fad7e9e5",            "primaryContactFirstName": "John",            "primaryContactLastName": "Doe",            "primaryContactTitle": null,            "primaryContactPhone": null,            "primaryPhone": null        },        "corporateVerification": [            {                "id": "1234567d-1bfb-49f2-b5ee-04e01ead834b",                "legalEntityVerification": true,                "verificationStatus": "Pending",                "verificationDate": "2020-12-04",                "verificationSource": "DUNS",                "businessStatement": null,                "nextReviewDate": "2022-12-04",                "verificationIssues": []            }        ],        "supportingDocuments": {            "supportDocs": true,            "docsPending": [],            "docsReview": [],            "docsAccepted": []        },        "amlScreening": [            {                "id": 589,                "ongoing": false,                "screenDate": "2020-12-04",                "nextReview": "2022-12-04",                "searchTerm": "John Doe",                "searchTypes": [                    "person"                ],                "searchFuzziness": 40,                "searchCoverage": [                    "Warning",                    "Pep Class 1"                ],                "pending": 17,                "accepted": 0,                "unknown": 0,                "sanctions": 0,                "politicalExposure": 0,                "adverseMedia": 0,                "linkedEntityIds": [                    "1234567d-0e47-4079-8b01-353af8b0ef33"                ]            }        ]    }}
```

400: Bad Request

```
{    "code": 400,    "status": "failure",    "message": "wrong entity type",    "data": null}
```

404: Not Found

```
{    "code": 404,    "status": "failure",    "message": "there is no legal entity with given id",    "data": null}
```

**GetLegalEntityIDBySearchParameter**

`GET` `https://api.icomplykyc.com/api/v2/entities/legal-entities`

Search for legal entities by various parameters.

**Authentication Type:** API Key

**Sample Query:** [https://api.icomplykyc.com/api/v2](https://api.icomplykyc.com/api/v2)/legal-entities?duns=150483782&glei=5299019D9BIL4D4UHT93&companyName=Starbucks Coffee Company

 

**Query Parameters**

| Name | Type | Description |
| --- | --- | --- |
| externalID | String | External ID of the Legal Entity |
| duns | Int | DUNS Number of the Legal Entity |
| glei | String | GLEI Number of the Legal Entity |
| companyName | String | Company Name of the Legal Entity |
| registrationNumber | String | Corporate Registration Number of the Legal Entity |
| email | String | Email address associated with the primary contact of the legal entity |
| phone | String | Phone number associated with the legal entity |

 

200: OK 

```
{    "code": 200,    "status": "success",    "message": "",    "data": [        "1234567-cd5f-4985-9175-c50ecc21f010"    ]}
```

 

**Request Updated Information About this Legal Entity**

`GET` `https://api.icomplykyc.com/api/v2/entities/legal-entities/{entityID}/request-client-update`

Sends an e-mail to the primary contact for this Legal Entity and requests updated information or supporting documents about this Legal Entity.

**Sample Request Body**

{

"recepientId": "string",

"emailSubject": "string",

"emailMessage": "string",

"configId": 0, "domain":

"string"

}

 

200: OK Success, 400: Bad Request, and 401: Unauthorized

```
{    // Response}
```

 

**Add Legal Entity**

**Sample Request Body**

To create a new Legal Entity, initiate a POST request to [https://api.icomplykyc.com/api/v2](https://api.icomplykyc.com/api/v2)**/entities/legal-entities** with the following JSON payload.

 

```
{    "kybMetaData": {        "kycStatus": "new",        "externalID": "Starbucks555"    },    "kycServices": {        "requestCIV": true,        "requestAML": true    },    "corporateInformation": {        "companyName": "Starbucks Coffee Company",        "alsoKnownAs": ["Starbucks", "Starbucks Coffee"],        "doingBusinessAs": "Starbucks",        "formerlyKnownAs": ["Seattle's Starbucks"],        "registrationNumber": "1234-3456-980",        "dateofIncorporation": "1971-03-30",        "jurisdictionOfIncorporation": "US",        "jurisdictionOfDomicile": "US",        "jurisdictionOfTaxResidence": "KY",        "duns": "150483782",        "glei": "5299019D9BIL4D4UHT93",        "companyPhone": "555-010-0123",        "primaryAddress": "777 Columbia St",        "city": "New Westminster",        "stateProvince": "BC",        "country": "CA",        "postalCode": "V3M 1B6",        "linkedEntities": [            {                "relationship": "Advisor",                "entityId": "018cf32c-f4bc-4217-a797-493b729a3ae9"            },            {                "relationship": "Officer",                "entityId": "04831052-235e-4de5-be35-eb9c4ddb33e4"            }        ],        "email": "johndoe@gmail.com",        "primaryContactFirstName": "John",        "primaryContactLastName": "Doe",        "primaryPhone": "555-242-0123",        "primaryContactPhone": "555-313-0123"    },    "corporateVerification": {        "verificationStatus": "pending",        "verificationDate": "2020-09-25",        "verificationSource": "DUNS",        "businessStatement": "To establish Starbucks as the premier purveyor of the finest coffee in the world while maintaining our uncompromising principles while we grow.",        "nextReviewDate": "2022-09-25"    },    "amlScreening": {        "ongoing": false,        "searchTerm": {            "name": "John Doe",            "yearOfBirth": 1969,            "countries": ["US"]        },        "searchType": "person",        "searchFuzziness": 40,        "searchCoverage": ["sanctions", "warning", "pep-class-1"],        "linkedEntityIds": ["018cf32c-f4bc-4217-a797-493b729a3ae9", "04831052-235e-4de5-be35-eb9c4ddb33e4"]    }}
```

 

**AddLegalEntity**

`POST` `https://api.icomplykyc.com/api/v2/entities/legal-entities`

**Authentication Type:** API Key

**Sample Query:** [https://api.icomplykyc.com/api/v2](https://api.icomplykyc.com/api/v2)/entities/legal-entities

**Request Body** 

| Name | Type | Description |
| --- | --- | --- |
| Raw\* | JSON | See above sample payload bod |

201: Created

```
{    "code": 201,    "status": "success",    "message": "legal entity was successfully created",    "data": {        "id": "368bf475-3c52-4f6f-a057-ba0a2346e546"    },    "errors": []}
```

400: Bad Request

```
{    "code": 400,    "status": "failure",    "message": "legal entity could not be created",    "data": null,    "errors": [        "Company name is missing"    ]}
```

409: Conflict

```
{    "code": 409,    "status": "failure",    "message": "there is already registered organization with given name and duns number",    "data": null}
```

 

# iComply Investor Services Inc - icomplyis.com

icomplyis.com Help Center

Copyright © 2025, iComply Investor Services Inc - icomplyis.com