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

# API Introduction

> Getting started with KillB API

## Welcome to KillB API

The KillB API is a REST API that enables cryptocurrency on-ramps and off-ramps across Latin America. Convert between fiat currencies (COP, MXN, USD) and cryptocurrencies (USDC, USDT) with ease.

## Base URLs

<Tabs>
  <Tab title="Sandbox">
    ```
    https://sandbox.killb.app
    ```

    Use for development and testing with fake money.
  </Tab>

  <Tab title="Production">
    ```
    https://killb.app
    ```

    Use for real transactions with actual funds.
  </Tab>
</Tabs>

## Authentication

All API requests require authentication:

```bash theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

<Card title="Authentication Guide" icon="key" href="/es/authentication">
  Learn how to authenticate with the API
</Card>

## API Structure

The KillB API is organized into the following resources:

| Resource       | Description                | Base Path            |
| -------------- | -------------------------- | -------------------- |
| **Auth**       | Login and token management | `/api/v2/auth`       |
| **Users**      | User management and KYC    | `/api/v2/users`      |
| **Accounts**   | Bank accounts and wallets  | `/api/v2/accounts`   |
| **Ramps**      | On/off-ramp transactions   | `/api/v2/ramps`      |
| **Quotations** | Price quotes               | `/api/v2/quotations` |
| **Savings**    | Custodial accounts         | `/api/v2/savings`    |
| **Webhooks**   | Event notifications        | `/api/v2/webhooks`   |
| **Customers**  | Customer management        | `/api/v2/customers`  |
| **Banks**      | Bank information           | `/api/v2/banks`      |

## Making Requests

### Request Format

All requests use JSON:

```bash theme={null}
curl --request POST \
  --url https://sandbox.killb.app/api/v2/users \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "PERSON",
    "data": { /* user data */ }
  }'
```

### Response Format

Successful responses return JSON with relevant data:

```json theme={null}
{
  "id": "resource-id",
  "status": "ACTIVE",
  /* other fields */
}
```

Error responses include error details:

```json theme={null}
{
  "errorCode": "USER.0001",
  "message": ["User not found"],
  "statusCode": "404"
}
```

## Pagination

List endpoints support pagination:

```bash theme={null}
GET /api/v2/users?page=1&limit=10
```

**Response:**

```json theme={null}
{
  "users": [ /* array of users */ ],
  "totalPage": 5
}
```

## Idempotency

Use `externalId` field for idempotent operations:

```json theme={null}
{
  "externalId": "your-unique-id",
  /* other fields */
}
```

This prevents duplicate resource creation on retries.

## Testing

Use sandbox environment for testing:

<CardGroup cols={2}>
  <Card title="Sandbox Guide" icon="flask" href="/es/sandbox">
    Test safely without real funds
  </Card>

  <Card title="Demo Apps" icon="grid" href="/es/demo-apps">
    View example implementations
  </Card>
</CardGroup>

## API Explorer

Explore the complete API reference using the navigation on the left. Each endpoint includes:

* Request/response schemas
* Code examples
* Parameter descriptions
* Error responses

## Need Help?

<CardGroup cols={2}>
  <Card title="Soporte por email" icon="envelope" href="mailto:tech@killb.com">
    Comunícate con nuestro equipo
  </Card>

  <Card title="Agendar llamada" icon="calendar" href="https://www.killb.com/contact">
    Reserva una demo
  </Card>
</CardGroup>