> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.withverifa.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.withverifa.com/_mcp/server.

# API Details

> Authentication, pagination, error handling, and other API conventions.

This section covers the conventions and behaviors that apply across all Verifa
API endpoints.

| Topic              | What it covers                                    |
| ------------------ | ------------------------------------------------- |
| **Authentication** | API key usage and environment scoping             |
| **Pagination**     | Offset-based and cursor-based pagination patterns |
| **Rate Limiting**  | Request limits and retry strategies               |
| **Versioning**     | API version headers and compatibility policy      |
| **Errors**         | Error response format and common status codes     |
| **Webhooks**       | Event types, delivery, and signature verification |
| **Idempotency**    | Safe retries with idempotency keys                |
| **Key Inflection** | camelCase / snake_case response formatting        |
| **Data Access**    | Scoped API key permissions and data visibility    |
| **Data Retention** | PII lifecycle, redaction, and automatic expiry    |