---
title: "Legacy V1 endpoint with a limited free evaluation allowance."
method: POST
path: "/extract"
tags: ["Legacy V1 evaluation API"]
deprecated: true
---

# Legacy V1 endpoint with a limited free evaluation allowance.

`POST /extract`

> **Deprecated.**

Use this legacy endpoint only to try SchemaSure free (3 limited calls per client) or maintain an existing V1 integration. New production agents should use /v2/extract.

## Request body

- ExtractRequest
  - `input` string, required — Raw unstructured content to extract from (plain text or HTML).
  - `inputType` 'text' | 'html' | 'auto' — How to interpret `input`: plain text, HTML, or auto-detect (default).
  - `schema` object, required — JSON Schema (draft 2020-12) that the returned `data` is guaranteed to satisfy.
  - `options` object
    - `maxRepairs` integer — Max validate->re-prompt repair iterations.
    - `strict` boolean — Drop fields not present in the schema.
    - `deterministic` boolean — Enable deterministic pre-extraction hints.

## Response `200`

Schema-valid extraction. Paid responses include X-PAYMENT-RESPONSE.

- ExtractSuccess
  - `data` unknown, required
  - `meta` object, required
    - `repairs` integer, required
    - `latencyMs` integer, required
    - `validated` unknown, required
    - `deterministicFields` string[]

## Other responses

- `400` — Bad request, unsupported input, invalid JSON Schema, or decoded input too large; fix before retrying. Not settled.
- `402` — Legacy V1 payment required or invalid. The response body contains the V1 accepts quote.
- `413` — Encoded HTTP request body is too large; reduce it before retrying. Not settled.
- `422` — Could not produce schema-valid output; change the input/schema or use a fallback. Not settled.
- `429` — Rate limited. Wait for Retry-After before retrying. Not settled.
- `500` — Unexpected server error. Retry once with backoff, then report X-Request-ID. Not settled.
- `502` — Inference or payment upstream unavailable. Retry with bounded exponential backoff. Not settled.
- `504` — Extraction timed out. Retry with bounded exponential backoff. Not settled.

---

[API](https://skmtc.dev/schemasure/apis/schemasure-structured-extraction.md) · [All operations](https://skmtc.dev/schemasure/apis/schemasure-structured-extraction/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/schemasure/schemasure-structured-extraction/revisions/86c44d5ada4d/schema)