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

# API reference

> Overview of Kairo Shield integration endpoints

This reference covers **fintech integration** endpoints.

## Base URL

Replace `{BASE_URL}` with the URL provided by Kairo Connect:

| Environment | Example |
| - | - |
| Staging | `https://staging-api.kairoshield.com` |
| Production | `https://api.kairoshield.com` |

All integration routes live under `{BASE_URL}/api/v1`.

## Integration endpoints

| Method | Path | Description |
| - | - | - |
| `POST` | `/score` | Real-time fraud scoring for one transaction |
| `POST` | `/score/batch` | Batch scoring (up to 1,000 transactions) |
| `POST` | `/feedback` | Confirmed fraud or legitimate label |
| `POST` | `/webhooks` | Register webhook |
| `GET` | `/webhooks` | List client webhooks |
| `GET` | `/webhooks/{id}` | Get one webhook |
| `PUT` | `/webhooks/{id}` | Update webhook |
| `DELETE` | `/webhooks/{id}` | Delete webhook |
| `GET` | `/webhooks/{id}/logs` | Delivery history |
| `POST` | `/webhooks/{id}/test` | Send test payload |

## Health checks (no auth)

| Method | Path | Purpose |
| - | - | - |
| `GET` | `/health` | Liveness — process is alive |

## Authentication

All integration routes require the `X-API-Key` header. See [Authentication](/docs/shield/authentication).

## Error format

Errors follow **RFC 7807** (Problem Details). See [Common errors](/docs/shield/errors).


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