Skip to main content
POST
/
api
/
kyb
/
register
Register Business (KYB)
curl --request POST \
  --url https://api.teel.finance/api/kyb/register \
  --header 'Content-Type: application/json' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "businessName": "<string>",
  "businessType": "<string>",
  "registrationNumber": "<string>",
  "country": "<string>",
  "address": {
    "street": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>",
    "country": "<string>"
  },
  "contactEmail": "<string>",
  "contactPhone": "<string>"
}
'
{
  "registrationId": "kyb_abc123def456",
  "status": "pending",
  "providers": {
    "conduit": "pending",
    "lemonado": "pending",
    "circle": "pending"
  }
}
Submits KYB (Know Your Business) information to register a business with all connected providers simultaneously. Requires the X-User-ID header to associate the registration with a user.

​
Headers

​
X-User-ID
string
required
The unique identifier of the user initiating the KYB registration.

​
Body Parameters

​
businessName
string
required
Legal name of the business.
​
businessType
string
required
Type of business entity (e.g. llc, corporation, sole_proprietorship).
​
registrationNumber
string
required
Business registration or EIN number.
​
country
string
required
ISO 3166-1 alpha-2 country code where the business is registered (e.g. US, GB).
​
address
object
required
Registered business address.
​
contactEmail
string
required
Primary contact email for the business.
​
contactPhone
string
Primary contact phone number.

​
Response

​
registrationId
string
Unique identifier for this KYB registration.
​
status
string
Overall registration status (e.g. pending, approved, rejected).
​
providers
object
Map of provider names to their individual registration statuses.
{
  "registrationId": "kyb_abc123def456",
  "status": "pending",
  "providers": {
    "conduit": "pending",
    "lemonado": "pending",
    "circle": "pending"
  }
}