Overview - Matil Documentation

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:

{
  "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.