> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.trevex.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.trevex.io/_mcp/server.

# 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](/webhooks))
* [ ] Your webhook endpoint returns a `2xx` status to acknowledge receipt

## Your first KYB request in 3 steps

### 1. Upload the trade license

#### cURL

```bash
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:

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

### 2. Submit the KYB request

#### cURL

```bash
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](/webhooks) for the schema.

## Next steps

#### [KYB Request Lifecycle](/kyb-lifecycle)

Learn the status model and how to handle rejections.

#### [Full API Reference](/api-reference)

Every endpoint, parameter, and response.