/v2/extract endpoint a JSON schema describing the fields you want, and the API returns them filled in with values.
Extraction is the right operation when you already know what matters: line items from an invoice, headline terms from a contract, fields from a lab report. Each value comes with a confidence score, so you can flag uncertain extractions for human review before they hit a database.
From a Fund Report to Typed Fields
The mutual fund performance page below has a header, a growth-of-$1,000,000 chart, and an average annual total return table broken out by share class. Extraction reads all of that and returns just the fields named in our schema, with a confidence score on every value. The rows of the returns table come back as structured objects of their own.
| Field | Extracted value | Confidence |
|---|---|---|
fund_name | Calamos Market Neutral Income Fund | 99.5% |
returns_as_of_date | 10/31/23 | 99.5% |
share_classes array, each as its own structured object with a confidence score on every value:
| Share class | Inception | 1-Year | 5-Year | 10-Year / Since Inception |
|---|---|---|---|---|
| Class A Shares | 9/4/90 | 7.76% | 3.25% | 3.28% |
| Class C Shares | 2/16/00 | 6.93 | 2.47 | 2.50 |
| Class I Shares | 5/10/00 | 8.07 | 3.52 | 3.53 |
| Class R6 Shares | 6/23/20 | 8.08 | — | 3.46 |
Defining a Schema
Extraction schemas follow the JSON Schema spec. The most important thing in the schema is thedescription you give each field. Keep descriptions as detailed and specific as possible. Clear, pointed descriptions help the model correctly locate and extract the intended information, especially in complex or ambiguous documents.
See the Schemas reference for the rules, supported types, and worked examples.
How Extraction Works
Once you submit a schema:- Unsiloed locates each named field in the document.
- Extracts a value of the right type for each one.
- Returns the values as structured JSON, each with a confidence score.
Schema Tips
- Keep field names simple and descriptive.
- Use nested objects to reflect document structure.
- Avoid free-form schemas; strict schemas produce better results.
- Prefer arrays for repeated sections (line items, directors, transactions).
Dig Deeper
Schemas
JSON Schema rules, supported types, and worked examples for invoices and SEC filings.
Response Format
The canonical extraction response with a field-by-field reference.