---
title: "Start extraction"
method: POST
path: "/api/v1/external/shipments/{shipmentId}/documents/{documentId}/extract"
tags: ["Documents"]
---

# Start extraction

`POST /api/v1/external/shipments/{shipmentId}/documents/{documentId}/extract`

## Request

- Base URL: `https://api.wove.com`
- URL: `https://api.wove.com/api/v1/external/shipments/{shipmentId}/documents/{documentId}/extract`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wove/apis/wove-external-api/docs/api/v1/external/shipments/:shipmentId/documents/:documentId/extract/post.ts> (a function with typed inputs; its response is checked against the schema)

Start or restart extraction for a document.

## Path parameters

- `shipmentId` string, required
- `documentId` string, required

## Request body

- object
  - `reprocess` boolean: Force reprocessing even if already extracted
  - `fields` string[]: Specific fields to extract

## Response `200`

Extraction started successfully

- object
  - `success` boolean
  - `data` object
    - `jobId` string
    - `message` string

---

[API](https://skmtc.dev/wove/apis/wove-external-api.md) - [All operations](https://skmtc.dev/wove/apis/wove-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wove/apis/wove-external-api/revisions/37290e267e07?raw)