# Setting up a webhook

Rather than manually retrieving results using the [](https://manual.personr.co/api-documentation/entity-results/retrieving-entity-verification-results "mention") endpoint, you can set up a webhook that sends the verification status and data to your API once a verification has finished processing.

Providing us your endpoint URL is easy. Simply head to <https://enterprise.personr.co/dashboard/dev-space> and click on Webhooks.

Enter your API endpoint that's listening, and hit Save.

<figure><img src="https://2927352434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAmEVMxhOOdXgxn7sjnz%2Fuploads%2FIqZoJbMXSJDRkhTz1Gqz%2FScreenshot%202024-02-28%20at%2012.28.43%E2%80%AFpm.png?alt=media&#x26;token=5571b80b-0cb7-424a-b9ae-9340357d7464" alt=""><figcaption></figcaption></figure>

Be sure to generate a webhook authentication token, and only accept authenticated calls from us. We'll send a POST request to your endpoint, with your generated token in the header.&#x20;

#### Webhook Response

```json
{
  "applicantId": "140000249274x80293840283",
  "status": "Reviewed",
  "reviewAnswer": "Rejected",
  "rejectLabels": [
    "SANCTIONS",
    "COMPROMISED_PERSONS"
  ],
  "entityType": "AUSTRALIAN PROPRIETARY COMPANY, LIMITED BY SHARES",
  "registrySource": "AUSTRALIAN SECURITIES & INVESTMENTS COMMISSION",
  "registeredAddress": "123 EXAMPLE LANE, PERTH, 6000, WA, AUSTRALIA",
  "companyName": "EXAMPLE LTD",
  "registrationNumber": "123 456 789",
  "incorporatedOn": "2020-12-01",
  "representativeEmail": "example@personr.co",
  "representativePhone": "0400 000 000",
  "flowQuestions": [
    "Example Question 1",
    "Example Question 2"
  ],
  "flowAnswers": [
    "Entity Answer 1",
    "Entity Answer 2"
  ],
  "flow": "KYB Basic"
  "sourceKey": "Example Source Key",
  "externalUserId": []
}
```