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

# Receive Result Notification

> Callback payload sent by PCI Booking when a contact verification session completes.

<Card title="Contact Verification Guide" icon="book" href="/additional-functions/contact-verification">
  How the email + OTP verification flow works end-to-end
</Card>

If a `callbackUrl` was provided when [creating the verification](/api-reference/additional/create-verification), PCI Booking sends a POST request to that URL when the session reaches a terminal state (`Verified`, `Failed`, or `Expired`).

Your endpoint must be publicly accessible and should return a `2xx` HTTP status code to acknowledge receipt.

<Info>
  The callback payload uses the same structure as the [Get Verification Status](/api-reference/additional/get-verification-status) response.
</Info>

<Info>
  The `metadata` field contains the value provided in the original Create request, making it easy to correlate the notification with your internal records.
</Info>

<Warning>
  Callback delivery is best-effort. If your endpoint is unreachable or returns a non-2xx status, the failure is logged but does not affect the verification outcome. Use [Get Verification Status](/api-reference/additional/get-verification-status) or [Get Verification Results](/api-reference/additional/get-verification-results) as a fallback.
</Warning>

## Callback Payload

| Field         | Type     | Description                                                                   |
| ------------- | -------- | ----------------------------------------------------------------------------- |
| `verifyId`    | string   | The unique ID of the verification session.                                    |
| `status`      | string   | The terminal status. Possible values: `Verified`, `Failed`, `Expired`.        |
| `completedAt` | datetime | The UTC datetime at which the session reached its terminal status.            |
| `metadata`    | string   | The metadata string provided in the original request. `null` if not provided. |

```json theme={null}
{
    "verifyId": "xLoat3F385vvFRbgI2usOeuXKXQoB8kv",
    "status": "Verified",
    "completedAt": "2026-03-15T18:47:10Z",
    "metadata": "MY-REFERENCE_098"
}
```