Legal Entity Management API


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


To connect to the Legal Entity Management API, you must use the basic authentication credentials of your web service user. If you don’t have one, contact the Adyen Support Team. Use the web service user credentials to authenticate your request, for example:

-U "ws_123456@Scope.BalancePlatform_YourBalancePlatform":"YourWsPassword" \
-H "Content-Type: application/json" \

Note that when going live, you need to generate new web service user credentials to access the live endpoints.


The Legal Entity Management API supports versioning of its endpoints through a version suffix in the endpoint URL. This suffix has the following format: “vXX”, where XX is the version number.

For example:

Going live

When going live, your Adyen contact will provide your API credential for the live environment. You can then use the username and password to send requests to

Use this page to mock Legal Entity Management API in your testing and development.

Run our mock API sample using the open source WireMock library, or in the free edition of WireMock Cloud. You'll have a working API server simulating the behavior of Legal Entity Management API, which will allow you to keep building and testing even if the actual API you isn't currently available.

Related mocks



Adyen Checkout Utility Service

A web service containing utility


Taxamo’s elegant suite of APIs and

Fund API

This API is used for the classic

Hosted onboarding API

This API is used for the classic

Ready to accelerate your development flow

Shorter release cycles, more predictable schedules and fewer defects in production.
Start Mocking for Free *Free forever. No credit card needed