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

# Closeout endpoints

> Search-type-specific webhook endpoint configuration.

# Closeout endpoints

Search-type-specific webhook destinations under `webhookConfig.closeoutEndpoints`.

<Note>
  Only `EMPLOYMENT` and `EDUCATION` search types are supported.
</Note>

## Fields

| Field        | Required | Type     | Description |         |                                                                                                                                                   |
| ------------ | -------- | -------- | ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `EMPLOYMENT` | No       | \`string | object      | array\` | Employment verification webhooks. Accepts a URL string, a single [webhook target](/api-reference/schemas/webhook-target), or an array of targets. |
| `EDUCATION`  | No       | \`string | object      | array\` | Education verification webhooks. Accepts the same shapes as `EMPLOYMENT`.                                                                         |

## Example

```json theme={null}
{
  "EMPLOYMENT": [
    {
      "url": "https://client.example.com/webhooks/employment-closeout",
      "headers": { "X-Customer": "acme" },
      "events": ["verification.completed"]
    },
    {
      "url": "https://client.example.com/webhooks/employment-notifications",
      "events": ["verification.notification"]
    }
  ],
  "EDUCATION": [
    {
      "url": "https://client.example.com/webhooks/education-closeout",
      "basicAuth": { "username": "api", "password": "secret" },
      "events": ["verification.completed"]
    }
  ]
}
```

## Validation rules

* All fields are optional - specify only the search types you need
* Endpoint URLs must be valid URLs. Production webhook delivery requires HTTPS; non-production may also accept `http://localhost` and `http://127.0.0.1` for local testing
* If a search type endpoint is not specified, the `fallbackEndpoint` from `Webhook config` will be used
* When `events` is omitted, the webhook defaults to receiving only `verification.completed` (backward compatible)
* You can attach per-target headers and basic auth; HMAC signature header will still be sent (per-target secret overrides global secret)

## Related schemas

* [Webhook config](/api-reference/schemas/webhook-config) — Parent webhook configuration schema
* [Webhook target](/api-reference/schemas/webhook-target) — Single webhook target schema