---
title: "Create a document order"
method: POST
path: "/v1/company-data/document-orders"
tags: ["Company data"]
---

# Create a document order

`POST /v1/company-data/document-orders`

Create a document order for a company

---

#### See also  
Learn more about [Company data](./company-data-guide)  
Learn more about [Companies](./company-get-one)  
Learn more about [Files](./files-guide)

## Request body

- DocumentOrderCreate
  - `company_id` string, uuid, required
  - `product_ref` string, required — Retrieve possible value from [List available documents](./company-data-available-documents).

## Response `201`

Document order has been created on the company

**ℹ️ Click to see full payload**

- DocumentOrder
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `product_ref` string, required
  - `name` string, required
  - `price_tier` string, required
  - `status` 'created' | 'processing' | 'completed' | 'failed', required
  - `file_id` string, nullable, required
  - `created_at` string, date-time, required — Creation date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `updated_at` string, date-time, required — Latest update date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)

## Other responses

- `400` — The request is either malformed or contain invalid parameters. - Make sure the body payload matches the expected schema

---

[API](https://skmtc.net/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.net/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dotfile/api-specifications/versions/36393567057b/schema)