---
title: "Create an order"
method: POST
path: "/teams/{team_id}/orders"
tags: ["Orders"]
---

# Create an order

`POST /teams/{team_id}/orders`

Creates a translation order. You must have admin privileges in the project you are placing an order in.

Requires <code>write_team_orders</code> OAuth access scope.

## Path parameters

- `team_id` number, required

## Request body

- object
  - `project_id` string, required — Project identifier.
  - `branch` string — Branch name.
  - `payment_method` 'credit_card' | 'team_credit' — Payment method. Possible values are <code>credit_card</code> (default) or <code>team_credit</code>.
  - `card_id` number — Identifier of the card used for payment. Required if <code>payment_method</code> = <code>credit_card</code>.
  - `briefing` string, required — Order briefing.
  - `source_language_iso` string, required — Source language code of the order.
  - `target_language_isos` string[], required — List of target languages.
  - `keys` string[], required — List of keys identifiers, included in the order.
  - `provider_slug` string, required — Translation provider slug.
  - `translation_tier` number, required — Tier of the translation. Tiers depend on provider.
  - `is_saved_to_translation_memory` boolean — Default true, can be set only with <code>google</code> and <code>deepl</code> providers.
  - `dry_run` boolean — Return the response without actually placing an order. Useful for price estimation. The card will not be charged. Defaults to <code>false</code> (live mode).
  - `translation_style` string — Only for <code>gengo</code> provider. Available values are <code>formal</code>, <code>informal</code>, <code>business</code>, <code>friendly</code>. Defaults to <code>friendly</code>.

## Response `200`

OK

- Orders
  - `order_id` string — A unique order identifier.
  - `project_id` string — Project identifier.
  - `branch` string — Branch name.
  - `payment_method` string — Payment method. Possible values are <code>credit_card</code>, <code>team_credit</code>, <code>none</code>. <code>null</code> will be returned for orders made before the attribute was introduced.
  - `card_id` number — Identifier of the card used for payment.
  - `status` string — Status of the order. Possible values are <code>in progress</code>, <code>completed</code>. <code>processing</code>, <code>draft</code> in case if <code>dry_run</code> = <code>true</code>.
  - `created_at` string — Date and time of the order creation.
  - `created_at_timestamp` number — Unix timestamp when the order was created.
  - `created_by` number — Identifier of a user, who has created the order.
  - `created_by_email` string — E-mail of a user, who has created the order.
  - `source_language_iso` string — Source language code of the order.
  - `target_language_isos` unknown[] — List of target languages.
    - unknown
  - `keys` unknown[] — List of keys identifiers, included in the order.
    - unknown
  - `source_words` object — Object, where object key is target language iso code and value is the translatable word count.
    - `{key}` string — Language iso code.
    - `{value}` number — Translatable word count.
  - `provider_slug` string — Translation provider slug.
  - `translation_style` string — Style of the translation, applies to <code>gengo</code> provider only.
  - `translation_tier` number — Tier of the translation. Tiers depend on provider.
  - `translation_tier_name` string — Tier name.
  - `briefing` string — Order briefing.
  - `is_saved_to_translation_memory` boolean — Default true, can be set only with <code>google</code> and <code>deepl</code> providers.
  - `total` number — Total cost of the order in major currency units (USD)

---

[API](https://skmtc.net/lokalise/apis/default-projects.md) · [All operations](https://skmtc.net/lokalise/apis/default-projects/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lokalise/default-projects/revisions/7bceba421b12/schema)