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

# Referencia API

> Todo lo que necesitas para integrar Timbre en tu aplicación

## URL Base

```
https://api.usatimbre.com
```

## Autenticación

Incluye tu llave API en cada solicitud:

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

<Card title="Ver guía completa de autenticación" icon="key" href="/authentication" />

## Explora la API

<CardGroup cols={2}>
  <Card title="Perfiles" icon="user" href="/api-reference/profile/get-by-rfc">
    Gestiona usuarios y su información fiscal por RFC o ID.
  </Card>

  <Card title="Organizaciones" icon="building" href="/api-reference/organization/get">
    Administra empresas y sus miembros.
  </Card>

  <Card title="Facturación" icon="file-invoice" href="/api-reference/timbre/create-invoice">
    Crea facturas desde tickets automáticamente.
  </Card>

  <Card title="Estado" icon="heart-pulse" href="/api-reference/health/check">
    Verifica la disponibilidad del servicio.
  </Card>
</CardGroup>

## Respuestas

<Tabs>
  <Tab title="Exitosa">
    ```json theme={null}
    {
      "success": true,
      "data": {
        "id": "inv_abc123",
        "status": "completed",
        "pdf_url": "https://..."
      }
    }
    ```
  </Tab>

  <Tab title="Error">
    ```json theme={null}
    {
      "success": false,
      "error": {
        "code": "INVALID_RFC",
        "message": "El RFC proporcionado no es válido"
      }
    }
    ```
  </Tab>
</Tabs>

## Códigos HTTP

| Código | Significado                   |
| ------ | ----------------------------- |
| `200`  | Solicitud exitosa             |
| `400`  | Error en los datos enviados   |
| `401`  | Llave API inválida o faltante |
| `404`  | Recurso no encontrado         |
| `429`  | Demasiadas solicitudes        |
| `500`  | Error interno del servidor    |