---
title: "Merge shipment documents"
method: POST
path: "/api/v1/external/shipments/{shipmentId}/documents/merge"
tags: ["Documents"]
---

# Merge shipment documents

`POST /api/v1/external/shipments/{shipmentId}/documents/merge`

## Request

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

Create a job to merge data from multiple documents within a shipment.
Intelligently combines data from related documents (e.g., commercial invoice and packing list).

## Path parameters

- `shipmentId` string, required

## Request body

- MergeDocumentsRequest
  - `documentIds` string[], required

## Response `200`

Merge job created successfully

- object
  - `success` boolean
  - `data` MergeJobResponse
    - `jobId` string
    - `status` 'pending' | 'processing' | 'completed' | 'failed'
    - `documentIds` string[]
    - `message` string

## Other responses

- `400`: Invalid request or documents not found
- `404`: Shipment not found

---

[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)