Legal Entity Management API

https://kyc-test.adyen.com/lem/v3
Click to copy

The Legal Entity Management API enables you to manage legal entities that contain information required for verification.

Authentication

Each request to the Legal Entity Management API must be signed with an API key. Generate an API key in your Customer Area if you have a platform setup or marketplace setup.

If you have an Adyen Issuing integration, generate an API key in your Balance Platform Customer Area.

To connect to the API, add an X-API-Key header with the API key as the value. For example:

curl
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
...

Versioning

The Legal Entity Management API supports versioning using a version suffix in the endpoint URL. This suffix has the following format: "vXX", where XX is the version number.

For example:

https://kyc-test.adyen.com/lem/v3/legalEntities

Going live

When going live, generate an API key in your live Customer Area if you have an Adyen for Platforms integration or live Balance Platform Customer Area if you have an Adyen Issuing integration.You can then use the API key to send requests to https://kyc-live.adyen.com/lem/v3.

Create a business line
Get a business line
Delete a business line
Update a business line
Upload a document for verification checks
Get a document
Delete a document
Update a document
Create a legal entity
Get a legal entity
Update a legal entity
Get all business lines under a legal entity
Check a legal entity's verification errors
Get a link to an Adyen-hosted onboarding page
Get PCI questionnaire details
Get Terms of Service document
Get Terms of Service information for a legal entity
Get Terms of Service status
Get a list of hosted onboarding page themes
Get an onboarding link theme
Create a transfer instrument
Get a transfer instrument
Delete a transfer instrument
Update a transfer instrument