Legal entities

Create a legal entity

Changed on May 31, 2025

Creates a legal entity.

This resource contains information about the user that will be onboarded in your platform. Adyen uses this information to perform verification checks as required by payment industry regulations. Adyen informs you of the verification results through webhooks or API responses.

Requests to this endpoint are subject to rate limits:

Live environments: 700 requests per 5 seconds.
Test environments: 200 requests per 5 seconds.
Failed requests are subject to a limit of 5 failures per 10 seconds.

post/legalEntities

Request

Base URL
https://kyc-test.adyen.com/lem/v1
URL
https://kyc-test.adyen.com/lem/v1/legalEntities
Auth
- HTTP basic
- or API key in header X-API-Key

Headers

x-requested-verification-codestring

Use a suberror code as your requested verification code. You can include one code at a time in your request header. Requested verification codes can only be used in your test environment.

Request body

capabilitiesobject

Contains key-value pairs that specify the actions that the legal entity can do in your platform.The key is a capability required for your integration. For example, issueCard for Issuing. The value is an object containing the settings for the capability.

referencestring

Your reference for the legal entity, maximum 150 characters.

type'individual' | 'organization' required

The type of legal entity.

Possible values: individual or organization

verificationPlanstring

A key-value pair that specifies the verification process for a legal entity. Set to upfront for upfront verification for marketplaces.

Response

OK - the request has succeeded.

capabilitiesobject

idstring required

The unique identifier of the legal entity.