Skip to main content
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
}
FieldTypeDescription
entry_idUUIDUnique identifier for this result.
resource_typestringAlways "structure".
resource_idUUIDThe structure used for extraction.
resource_version_numberintegerThe version of the structure applied.
dataobjectThe extracted data as structured JSON.
errorsarray or nullValidation errors, if any.
statusstringcompleted, completed_with_errors, or failed.
time_msintegerProcessing time in milliseconds.
pricefloatCost of this request.

​
Versioning

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