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

# Folio

> Async-first document-intelligence API — OCR, classify, and extract structured data from any clinical or administrative document.

Folio turns unstructured documents into structured data. Upload a file, and retrieve a typed JSON result via polling or webhook.

* **What it does** — reads PDFs, images, and scanned documents; identifies the document type; and pulls out named fields with per-field confidence scores.
* **Who it's for** — health-tech teams that need reliable, privacy-preserving extraction from clinical and administrative documents at scale.
* **Where it runs** — Azure Canada Central, Law 25-aligned, with optional de-identification.

## How it works

```
Upload                          Retrieve
POST /v1/documents      →        GET /v1/documents/{id}/result
```

Processing is **asynchronous**. A `POST /v1/documents` call returns a `202` with a document `id` almost instantly. The structured result is ready seconds to minutes later — retrieve it by polling or by subscribing to a webhook.

## How these docs are organised

| Section           | What you'll find                                                                                         |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| **Get started**   | Quickstart walkthrough, API key authentication                                                           |
| **Guides**        | Async model, webhooks, custom extraction schemas, de-identification, confidence & HITL, language support |
| **API reference** | Full endpoint specs auto-generated from the OpenAPI schema                                               |

## Start here

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Submit your first document and retrieve a structured result in under five minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn how API keys work and how to keep them safe.
  </Card>

  <Card title="Async model" icon="clock" href="/guides/async-model">
    Learn how to poll or subscribe to webhooks to retrieve your results.
  </Card>

  <Card title="Custom schemas" icon="table" href="/guides/custom-schemas">
    Define your own field list for any document type.
  </Card>
</CardGroup>