---
title: "Start an extraction job"
method: POST
path: "/v1/extractions/jobs"
tags: ["extractions"]
---

# Start an extraction job

`POST /v1/extractions/jobs`

Start an extraction job for the provided file and schema.

Args:
    params: The parameters for creating an extraction job.

Returns:
    The created extraction job.

## Request body

- ExtractJobCreateParams — Parameters for creating an extraction job.
  - `file_id` string, required — The ID of the file to extract from
  - `json_schema` object, required — The JSON schema to use for extraction

## Response `200`

The created extraction job

- ExtractionJob — A job for extracting structured data from documents.
  - `id` string, uuid, required — Unique identifier for the extraction job
  - `organization_id` string, uuid, required — ID of the organization that owns this job
  - `file_id` string, uuid, required — ID of the file being extracted
  - `created_at` string, date-time, required — When the job was created
  - `updated_at` string, date-time, required — When the job was last updated
  - `started_at` string, date-time, nullable, required — When the job started processing
  - `finished_at` string, date-time, nullable, required — When the job finished processing
  - `status` 'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed', required
  - `result` ExtractionResult, required — The result of an extraction job.
    - `data` object, required
    - `warnings` string[], required
  - `error` object, nullable, required — Error information if failed
  - `json_schema` object, required — The JSON schema used for extraction

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/2eece97b5ae5/schema)