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:

{
  "statusCode": 200,
  "url": "/apis/download/masked-token-string/"
}

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