> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thiqwave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit KYB

> Submit a Know Your Business verification application.

Submit a KYB application for your partner account. Thiqwave performs automated verification including document review, identity checks, and registry cross-referencing for UAE entities. You will receive a status update via webhook once the review is complete.

## Request

### Headers

<ParamField header="X-API-Key" type="string" required>
  Your Thiqwave API key.
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Must be `application/json`.
</ParamField>

### Body

<ParamField body="businessName" type="string" required>
  Your legal business name exactly as it appears on your commercial registration certificate.
</ParamField>

<ParamField body="registrationNumber" type="string" required>
  Your trade license number for UAE-registered entities.
</ParamField>

<ParamField body="country" type="string" required>
  ISO 3166-1 alpha-2 country code for your registered jurisdiction. Accepted values: `"AE"`.
</ParamField>

<ParamField body="uboName" type="string" required>
  Full legal name of the Ultimate Beneficial Owner (UBO) — the individual who owns or controls 25% or more of the business.
</ParamField>

<ParamField body="uboNationalId" type="string" required>
  National ID number or passport number of the UBO.
</ParamField>

<ParamField body="documents" type="object[]" required>
  Array of document objects supporting your application. You must include at least one document of each required type.

  <Expandable title="Document fields">
    <ParamField body="documents[].type" type="string" required>
      Document category. One of: `"trade_license"`, `"memorandum_of_association"`, `"ubo_id"`.
    </ParamField>

    <ParamField body="documents[].url" type="string" required>
      URL to the uploaded document file. Use a pre-signed URL from your storage provider or upload via the Thiqwave Files API.
    </ParamField>
  </Expandable>
</ParamField>

## Example

```bash cURL theme={null}
curl --request POST \
  --url https://api.thiqwave.com/v1/compliance/kyb \
  --header "X-API-Key: your-api-key" \
  --header "Content-Type: application/json" \
  --data '{
    "businessName": "Dubai Trading Company LLC",
    "registrationNumber": "1234567890",
    "country": "AE",
    "uboName": "Ahmed Al-Mansouri",
    "uboNationalId": "784-1985-1234567-1",
    "documents": [
      {
        "type": "trade_license",
        "url": "https://storage.example.com/docs/trade-license.pdf"
      },
      {
        "type": "memorandum_of_association",
        "url": "https://storage.example.com/docs/moa.pdf"
      },
      {
        "type": "ubo_id",
        "url": "https://storage.example.com/docs/ubo-id.pdf"
      }
    ]
  }'
```

## Response

<ResponseField name="id" type="string">
  Unique compliance check ID. Use this to query status via `GET /v1/compliance/:id`.
</ResponseField>

<ResponseField name="status" type="string">
  Initial status of the application. Always `"pending_review"` immediately after submission.
</ResponseField>

<ResponseField name="businessName" type="string">
  Legal business name as submitted.
</ResponseField>

<ResponseField name="submittedAt" type="string">
  ISO 8601 timestamp of submission.
</ResponseField>

## What happens next

After you submit:

1. Your application enters `pending_review` status and is queued for review.
2. Thiqwave's compliance team reviews your documents within **1–3 business days**.
3. If additional information is needed, your status changes to `more_information_required` and you receive a webhook with details of what to provide.
4. Once approved, your account status moves to `approved` and you can start processing live transactions.

<Tip>
  Subscribe to the `compliance.status_updated` webhook event to receive real-time notifications instead of polling `GET /v1/compliance/:id`.
</Tip>