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

# API Overview

> Reference guide for interacting with Leadblanc programmatically.

The Leadblanc REST API is built on standard HTTP verbs, JSON request and response bodies, and standard HTTP response status codes.

## Base URL

All requests must be directed to our production API gateway:

```bash theme={null}
https://api.leadblanc.com/v1
```

***

## Authentication

Every API call must include an `Authorization` header containing your live or test secret API key:

```http theme={null}
Authorization: Bearer lb_live_9f81a7b3c4d5e6f7...
```

> [!WARNING]
>
> Never share your secret API key in client-side code, public GitHub repositories, or browser scripts. All API calls using secret keys must be executed from your secure server-side environment.

***

## Status Codes

| Code | Status | Meaning |
| :- | :- | :- |
| `200` | `OK` | Request succeeded. |
| `201` | `Created` | Resource successfully created. |
| `400` | `Bad Request` | Missing required parameters or invalid payload formatting. |
| `401` | `Unauthorized` | Invalid or missing API key. |
| `403` | `Forbidden` | API key lacks permission or feature is locked by plan tier. |
| `429` | `Rate Limited` | Concurrency limit reached. Back off with exponential retry. |
| `500` | `Server Error` | Internal server fault. Contact support if persistent. |


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