Quick Start

Before you go live

Confirm the following with your TREVEX account manager:

• A Project has been created for your integration
• An API key has been generated and shared with you
• A webhook signing secret has been generated and shared with you
• A webhook_url is set on the Project
• The Project is linked to your TREVEX company (for Partner Program enrollment)
• Your webhook endpoint accepts POST requests with Content-Type: application/json
• Your webhook endpoint verifies the X-Trevex-Signature header before trusting the payload (see Webhooks)
• Your webhook endpoint returns a 2xx status to acknowledge receipt

Your first KYB request in 3 steps

1. Upload the trade license

$
curl -X POST 'https://api.trevex.io/apis/email/upload_document/' \
>
  -H 'Authorization: Api-Key YOUR_API_KEY' \
>
  -F 'file=@trade_license.pdf'

Response contains a url you’ll pass in the next step:

1
{
2
  "statusCode": 200,
3
  "url": "/apis/download/masked-token-string/"
4
}

2. Submit the KYB request

$
curl -X POST 'https://api.trevex.io/apis/email/create_claim/' \
>
  -H 'Authorization: Api-Key YOUR_API_KEY' \
>
  -H 'Content-Type: application/json' \
>
  -d '{
>
    "user_email": "john.doe@example.com",
>
    "registered_company_name": "Acme Corporation LLC",
>
    "country_code": "AE",
>
    "trade_license": "/apis/download/masked-token-string/",
>
    "license_no": "DED-123456",
>
    "registration_body": "DED"
>
  }'

Store the returned request_id - you’ll use it to track status and match the approval webhook.

3. Wait for the webhook

Once a TREVEX admin approves the KYB request, your configured webhook URL will receive a POST with the full company payload. See Webhooks for the schema.

Next steps