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

# Public result contracts

> Public result contracts for parsed outputs.

# Public result contracts

These pages describe the public, client-facing result contract for each family. Results are produced asynchronously, and the API is the only supported retrieval path. The contract is family-specific, but the public shape stays stable across families, so you can rely on the same general envelope and read the family page that matches the result you requested.

## Supported formats

| Family     | Supported formats                                                                                                                                         |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `CAD`      | `DWG`, `DXF`                                                                                                                                              |
| `GIS`      | `SHPZIP`, `SHP`, `GeoJSON`, `GPKG`, `KML`, `KMZ`, `GML`, `CSV`, `FGB`, `FileGDB`, `MapInfo`, `SpatiaLite`, `EsriJson`, `GeoJSONSeq`, `TopoJSON`, `GeoRss` |
| `MailKit`  | `EML`, `MBOX`, `EMLX`, `MHT`, `MHTML`, `TNEF`, `WinmailDat`, `P7S`, `P7M`, `MSG`, `PST`, `OST`                                                            |
| `MsOffice` | `DOCX`, `DOC`, `RTF`, `DOTX`, `DOCM`, `XLSX`, `XLS`, `CSV`, `TSV`, `XLSM`, `PPTX`, `PPT`, `PPTM`, `POTX`, `POTM`, `HTML`, `HTM`, `MD`, `Markdown`, `TXT`  |
| `OpenDoc`  | `ODT`, `ODS`, `ODP`, `ODG`, `ODF`, `FODT`, `FODS`, `FODP`, `EPUB`, `IDML`, `DBF`, `DIF`, `MIF`                                                            |
| `PDF`      | `PDF`                                                                                                                                                     |
| `Parquet`  | `Parquet`                                                                                                                                                 |
| `SQL`      | `SQL`                                                                                                                                                     |

## Upload limits

Upload limits depend on the ingestion path:

* Direct upload: up to `25 MB`
* Presigned upload: up to `100 MB`
* Effective cap: the lower of the endpoint default and `JWT maxInputBytesPerDocument` when that JWT limit is set

<CardGroup cols={2}>
  <Card title="CAD" icon="drafting-compass" href="/output-contracts/cad">
    Public JSON contract for CAD drawings.
  </Card>

  <Card title="GIS" icon="map" href="/output-contracts/gis">
    Public JSON contract for geospatial outputs.
  </Card>

  <Card title="MailKit" icon="envelope" href="/output-contracts/mailkit">
    Public JSON contract for mail and archive results.
  </Card>

  <Card title="MsOffice" icon="file-word" href="/output-contracts/msoffice">
    Public JSON contract for Microsoft Office content.
  </Card>

  <Card title="OpenDoc" icon="file-lines" href="/output-contracts/opendoc">
    Public JSON contract for OpenDocument content.
  </Card>

  <Card title="Parquet" icon="table" href="/output-contracts/parquet">
    Public JSON contract for Parquet datasets.
  </Card>

  <Card title="PDF" icon="file-pdf" href="/output-contracts/pdf">
    Public JSON contract for PDF results.
  </Card>

  <Card title="SQL" icon="database" href="/output-contracts/sql">
    Public JSON contract for SQL statement results.
  </Card>
</CardGroup>

## What clients can rely on

* The contract is public and stable for a given version.
* Results are returned after processing completes.
* The envelope stays client-facing and family-based.
* Optional fields may be omitted when they do not apply.
* Family-specific fields live in `document` or `attributes`, not in internal transport details.
* Order stays deterministic within each family.

## Shared envelope

```json theme={null}
{
  "schema_version": "1.0",
  "document": {},
  "warnings": [],
  "content": []
}
```

## Shared rules

* `schema_version` identifies the public contract version.
* `document` always appears.
* `warnings` always appears.
* `content` always appears for families that expose ordered content records.
* `attributes` holds family-specific data.
* `source_ref` carries provenance when the family exposes one.
* No page in this section documents internal worker behavior or transport mechanics.