Skip to main content

​
What it does

Create a business customer on LINK and receive a KYB link for them to complete verification. You can also query the customer later to check their KYB status.

​
Authentication

Include your server-side API key in the request headers for every call.

​
Create Business Customer

​
Endpoint:

POST /v2/customers - Creates a new business customer and returns a hosted kyb_link_url. 
{
  "business_name": "Acme Trading GmbH",
  "business_email": "[email protected]",
  "phone_number": "+49 30 1234567",
  "registered_address": "Friedrichstr. 123, 10117 Berlin",
  "registered_country": "GBR"
}
Field notes
FieldDescription
business_nameLegal registered name of the business.
business_emailContact email for KYB communications.
phone_numberE.164 format recommended (e.g., +49…)
registered_addressFull registered street address.
registered_countryISO-3166-1 alpha-3 (e.g., NGA, USA, GBR)

​
Response (201)

{
  "customer_id": "cus_8q2ZrwJ3b5",
  "kyb_link_url": "https://kyb.linkio.world/link/cus_8q2ZrwJ3b5",
  "status": "pending",
  "created_at": "2025-09-12T10:23:54Z"
}
Status values
StatusMeaning
pendingKYB link created; customer has not yet completed verification.
in_reviewSubmitted; under review by the compliance provider or team.
approvedKYB approved; customer can begin transacting.
rejectedKYB failed. Check the dashboard for the reason or next steps.
more_infoAdditional documents or clarifications are required.

​
Where do I see requirements?

The customer is guided through all required fields and document uploads in the hosted KYB form. For a complete list of possible information and documentation requirements, refer to the Compliance page.
Customers API Response