Submit a KYB request

Creates a company KYB request on behalf of a user identified by their email.

If the user exists, the admin request is created and immediately unblocked (user_verified: true).
If the user does not exist, a draft account is created, a verification email is sent, and the admin request is blocked (user_verified: false).

Creates a company KYB request on behalf of a user identified by their email. - If the user **exists**, the admin request is created and immediately unblocked (`user_verified: true`). - If the user **does not exist**, a draft account is created, a verification email is sent, and the admin request is blocked (`user_verified: false`).

Authentication

Authorizationstring

Pass your API key as Api-Key <your_api_key> in the Authorization header. API keys are issued per Project by the TREVEX team.

Request

This endpoint expects an object.

user_emailstringRequiredformat: "email"

Email of the person submitting the KYB request.

registered_company_namestringRequired

Legal registered name of the company.

country_codestringRequired=2 characters

ISO 3166-1 alpha-2 country code.

user_namestringOptional

Full name. Used only when creating a new account.

user_mobilestringOptional

Mobile number. Used only when creating a new account.

companyIDstringOptional

TREVEX company ID in the format TRXAE0000042. Omit or use "NEW_COMPANY" for a new unlisted company.

license_nostringOptional

registration_bodystringOptional

Issuing authority, e.g. DED, ADCCI.

trade_licensestringOptional

URL returned by upload_document, or any accessible document URL.

industry_sectorstringOptional

industry_industry_groupstringOptional

industry_industrystringOptional

industry_sub_industrystringOptional

Legacy single sub-industry. Prefer sub_industries.

sub_industrieslist of objects or stringsOptional

Preferred industry classification. Each item is {label, value}, or a plain string (in which case a slug ID is auto-generated from the label).

auth_sign_namestringOptional

auth_sign_designationstringOptional

auth_sign_work_emailstringOptionalformat: "email"

auth_sign_work_mobilestringOptional

auth_sign_nationalitystringOptional=2 characters

ISO 3166-1 alpha-2 nationality code. Must be exactly 2 characters.

auth_sign_authorized_signatorystringOptional

address_address_line_1stringOptional

address_address_line_2stringOptional

address_areastringOptional

address_citystringOptional

address_statestringOptional

address_countrystringOptional

address_postal_codestringOptional

address_telephonestringOptional

address_emailstringOptionalformat: "email"

address_working_hoursstringOptional

Response

KYB request submitted successfully.

statusCodeinteger

request_idstring

Unique KYB request reference. Store this for status polling and webhook matching.

messagestring

user_verifiedboolean

false if a new account is being created. The KYB request is blocked until email verification.

Errors

400

Bad Request Error

409

Conflict Error

1	curl -X POST https://api.trevex.io/apis/email/create_claim/ \
2	-H "Authorization: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"user_email": "john.doe@example.com",
6	"registered_company_name": "Acme Corporation LLC",
7	"country_code": "AE",
8	"user_name": "John Doe",
9	"user_mobile": "+971501234567",
10	"companyID": "TRXAE0000042",
11	"license_no": "DED-123456",
12	"registration_body": "DED",
13	"trade_license": "/apis/download/masked-token-string/",
14	"industry_sector": "Technology",
15	"industry_industry_group": "Software",
16	"industry_industry": "SaaS",
17	"sub_industries": [
18	{
19	"label": "Cloud Computing",
20	"value": "si3"
21	},
22	{
23	"label": "Artificial Intelligence",
24	"value": "si7"
25	}
26	],
27	"auth_sign_name": "John Doe",
28	"auth_sign_designation": "CEO",
29	"auth_sign_work_email": "john@acmecorp.com",
30	"auth_sign_work_mobile": "+971501234567",
31	"auth_sign_nationality": "AE",
32	"auth_sign_authorized_signatory": "John Doe",
33	"address_address_line_1": "123 Sheikh Zayed Road",
34	"address_address_line_2": "Floor 12",
35	"address_area": "DIFC",
36	"address_city": "Dubai",
37	"address_state": "Dubai",
38	"address_country": "UAE",
39	"address_postal_code": "00000",
40	"address_telephone": "+97142345678",
41	"address_email": "info@acmecorp.com",
42	"address_working_hours": "Mon-Fri 9am-6pm"
43	}'

1	{
2	"statusCode": 201,
3	"request_id": "REQ-ABC123XYZ789",
4	"message": "KYB request submitted successfully.",
5	"user_verified": true
6	}