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

# Retries and auto-disable

> How KYC retries failed deliveries, and when it stops sending.

KYC records every delivery and retries it when your endpoint doesn't accept it.
Each retry carries the same event (`data`), a new `meta.attempt` number, and a new signature and timestamp.

## What each response means

| Your endpoint returns | What KYC does |
| - | - |
| 2xx | The delivery succeeded. |
| 408, 429 or 5xx, a timeout, or a connection error | Retries on the schedule below. |
| 3xx, 401, 403, or another 4xx | Retries once, then the delivery fails. |
| 410 | The delivery fails and KYC disables your endpoint. |

A timeout means no response within 10 seconds.

## Retry schedule

A delivery is tried up to 8 times over about 31 hours.

| Attempt | Sent about this long after the previous one |
| - | - |
| 1 | Right after the event |
| 2 | 1 minute |
| 3 | 5 minutes |
| 4 | 30 minutes |
| 5 | 2 hours |
| 6 | 5 hours |
| 7 | 10 hours |
| 8 | 14 hours |

Each wait varies by up to 20% either way, so retries from many deliveries don't all arrive at once.
If you send a `Retry-After` header with a 429 or 5xx, KYC waits at least that long, up to 1 hour.

## Auto-disable

KYC disables your endpoint when:

* it returns **410**, or
* **50 deliveries in a row fail**, and the failures span **at least 3 days**.

A short outage doesn't disable your endpoint, however many deliveries fail during it.
A single success resets the count.

While your endpoint is disabled, KYC sends nothing to it, and events from that time are not delivered later.
Contact KYC to re-enable it once it's fixed.

## Missed events

If your endpoint was down for longer than the retry schedule, contact KYC.
KYC can resend individual deliveries that failed.
Events from while your endpoint was disabled were never queued for it, so they can't be resent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.