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

# Vista general

> URL base, versiónado y formato de respuesta de la API de Matil.

La API de Matil te permite enviar documentos y recibir datos estructurados. Todas las peticiónes usan la URL base:

```
https://api.matil.ai/v3
```

## Formato de respuesta

Los endpoints de procesamiento devuelven está estructura:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "entry_id": "01934b1a-89ab-7def-0123-456789abcdef",
  "resource_type": "structure",
  "resource_id": "01934b1a-1234-7abc-0000-111122223333",
  "resource_version_number": 1,
  "data": {
    "numero_factura": "FAC-2024-001",
    "fecha": "2024-01-15",
    "total": 150.00
  },
  "errors": null,
  "status": "completed",
  "time_ms": 2340,
  "price": 0.05
}
```

| Campo                     | Tipo         | Descripción                                      |
| ------------------------- | ------------ | ------------------------------------------------ |
| `entry_id`                | UUID         | Identificador único de este resultado.           |
| `resource_type`           | string       | Siempre `"structure"`.                           |
| `resource_id`             | UUID         | La estructura utilizada para la extracción.      |
| `resource_version_number` | integer      | La versión de la estructura aplicada.            |
| `data`                    | object       | Los datos extraídos como JSON estructurado.      |
| `errors`                  | array o null | Errores de validación, si los hay.               |
| `status`                  | string       | `completed`, `completed_with_errors` o `failed`. |
| `time_ms`                 | integer      | Tiempo de procesamiento en milisegundos.         |
| `price`                   | float        | Coste de esta petición.                          |

## Versionado

La versión actual de la API es `v3`. Todos los endpoints llevan el prefijo `/v3/`. Mantenemos compatibilidad hacia atras dentro de una versión.