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

# Company Verification

> SynchPay provides a webhook to notify you when the Know-Your-Business (KYB) verification process is completed. This allows you to automatically respond to changes in a company's verification status without the need to continuously poll the status endpoint.

### Event Trigger

This webhook is triggered when the company's verification status changes to either:

* `Verified`
* `Rejected`

### Webhook Payload

```json theme={null}
{
  "Live": false,
  "Event": "COMPANY_VERIFICATION_STATUS_CHANGED",
  "Data": {
    "CompanyId": "d549b2af-3752-4844-8d55-475d3462df2a",
    "Status": "Verified"
  }
}
```

#### Payload Fields

| Field            | Type   | Description                                                  |
| :--------------- | :----- | :----------------------------------------------------------- |
| `Live`           | bool   | It's `true` when coming from production environment          |
| `Event`          | string | The event name: always `COMPANY_VERIFICATION_STATUS_CHANGED` |
| `Data.CompanyId` | string | Unique identifier of the company                             |
| `Data.Status`    | string | New status: `Verified` or `Rejected`                         |
| `Data.Timestamp` | string | ISO timestamp indicating when the event occurred.            |

The company status may remain Unverified for up to 24 hours while KYB is being processed.

### Related Endpoints

If you need to manually check a company's status, use the following endpoint:

**GET** `/company/status`

```http theme={null}
GET https://api.synchpay.com/company/status
Authorization: Bearer <AccessToken>
```

**Response example:**

```json theme={null}
{
  "CompanyId": "d549b2af-3752-4844-8d55-475d3462df2a",
  "Status": "Verified"
}
```