Legal Entity Management API
Legal Entity Management API
Adyen Legal Entity Management API runs KYC/KYB workflows on Balance Platform — identity verification, document collection, compliance review.
Built-in multi-country compliance rules (EU/US major markets)
Only usable within Balance Platform — not a standalone KYC SaaS
POST /legalEntities to create a legal entity (individual or organization); POST /documents to submit; status delivered via webhook.
Uptime · 30-day window
About this API
Within Balance Platform, every account holder receiving funds (marketplace seller, driver, SaaS customer) must pass KYC/KYB before receiving payouts — anti-money-laundering (AML) and sanctions-list compliance requirements. Legal Entity Management API is the entry point: create a legal entity (individual or organization), upload required documents (ID, business registration, UBO information), and Adyen automatically checks fraud databases and sanctions lists. Simple cases auto-approve within minutes; high-risk cases go to manual review (Adyen's internal team, typically 1-3 business days). Once approved, balanceAccount auto-activates for payouts. This lets platform businesses operate compliantly without building their own compliance team.
What you can build
- 1Identity verification for marketplace seller onboarding
- 2Recurring compliance review (annual or triggered)
- 3Business-entity due diligence (company / shareholders / beneficial owners)
- 4Differentiated compliance by country
Strengths & limitations
Strengths
- Built-in multi-country compliance rules (EU/US major markets)
- Supports document upload + auto-verification + human-review fallback
- Deep integration with Balance Platform (KYC completion auto-activates balanceAccount)
Limitations
- Only usable within Balance Platform — not a standalone KYC SaaS
- Some countries/regions have longer compliance review times
Example request
curl https://www.adyen.help/hc/en-us/community/topics/<endpoint>Getting started
POST /legalEntities to create a legal entity (individual or organization); POST /documents to submit; status delivered via webhook.
FAQ
What if KYC fails for a user?+
Adyen returns missing_required_data or invalid_data — the frontend prompts the user to supplement. Appeal flows are also supported.
Does KYC need to be redone annually?+
High-risk categories (e.g. certain countries) require periodic re-review. Adyen auto-triggers and notifies the platform via webhook.
Technical details
- Auth type
- unknown
- Pricing
- unknown
- Protocols
- REST
- SDKs
- java, python, javascript, php
- Response time
- 201 ms
- Last health check
- 5/12/2026, 7:36:31 AM
More from Adyen
Adyen Balance Control API moves funds between merchant accounts within Adyen — for centralized fund management and reconciliation.
Adyen BIN Lookup API returns card info from the first 6-8 digits of a PAN (BIN) — issuing bank, country, card type (debit/credit), product type.
Adyen Checkout API is the modern payments API for new integrations — pairs with frontend drop-in components, auto-adapting to 250+ payment methods.
Adyen Checkout Utility API provides auxiliary operations for Checkout API — originKey generation, payment methods listing, status queries.
Adyen Data Protection API handles GDPR/privacy operations — right-to-be-forgotten, PII deletion, shopper data export.
Adyen Payments API is its flagship payment-processing API — authorize, capture, and refund across cards, local payment methods, and wallets.
Adyen Payouts API moves funds from a merchant account out to external bank accounts or cards — supports multiple local clearing rails.
Adyen Recurring API manages subscription card tokens — store, look up, and reuse tokens for subsequent card-not-present payments.