> ## 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.

# Overview

> Base URL, versioning, and response format for the Matil API.

The Matil API lets you send documents and receive structured data back. All requests use the base URL:

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

## Response format

Processing endpoints return this structure:

```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": {
    "invoice_number": "INV-2024-001",
    "date": "2024-01-15",
    "total": 150.00
  },
  "errors": null,
  "status": "completed",
  "time_ms": 2340,
  "price": 0.05
}
```

| Field                     | Type          | Description                                        |
| ------------------------- | ------------- | -------------------------------------------------- |
| `entry_id`                | UUID          | Unique identifier for this result.                 |
| `resource_type`           | string        | Always `"structure"`.                              |
| `resource_id`             | UUID          | The structure used for extraction.                 |
| `resource_version_number` | integer       | The version of the structure applied.              |
| `data`                    | object        | The extracted data as structured JSON.             |
| `errors`                  | array or null | Validation errors, if any.                         |
| `status`                  | string        | `completed`, `completed_with_errors`, or `failed`. |
| `time_ms`                 | integer       | Processing time in milliseconds.                   |
| `price`                   | float         | Cost of this request.                              |

## Versioning

The current API version is `v3`. All endpoints are prefixed with `/v3/`. We maintain backward compatibility within a version.