---
title: "Add orders"
method: POST
path: "/api/v1/orders"
tags: ["Orders"]
---

# Add orders

`POST /api/v1/orders`

The method is used for transferring orders.<br/>To learn more, read <a href="https://docs.esputnik.com/docs/add-orders-api-method-for-order-transferring">Order Transfer Using the Generate event API Method.</a>

## Request body

- Orders — Order list (max <b>1000</b> orders per request).
  - `orders` Order[]
    - `externalOrderId` string, required — ID of an order in the external system
    - `externalCustomerId` string — External contact id. Required if email and phone are empty
    - `totalCost` number, required — Total cost of the order
    - `status` 'INITIALIZED' | 'IN_PROGRESS' | 'DELIVERED' | 'CANCELLED' | 'ABANDONED_SHOPPING_CART', required — Order status
    - `date` string, date-time, required — Order date and time
    - `currency` string, required — Currency according to <a href="https://en.wikipedia.org/wiki/ISO_4217">ISO 4217</a>
    - `email` string — Required if externalCustomerId and phone are empty
    - `phone` string — Required if email and externalCustomerId are empty
    - `firstName` string
    - `lastName` string
    - `shipping` number
    - `discount` number
    - `taxes` number
    - `restoreUrl` string
    - `statusDescription` string
    - `storeId` string — Store ID (if you have several stores in one eSputnik account)
    - `marketId` string — Customer market/region identifier. Optional parameter. Up to 64 characters. Allowed pattern: ^[a-zA-Z0-9_-]{1,64}$
    - `source` string — Online | offline values for segmentation. If the field is empty or some other value, by default the order will be accepted as online
    - `deliveryMethod` string
    - `paymentMethod` string
    - `deliveryAddress` string
    - `additionalInfo` object
    - `items` OrderItem[]
      - `externalItemId` string, required — Product ID in the external system
      - `name` string — Product name
      - `category` string — Product category
      - `quantity` number, double, required — Number of items
      - `cost` number — Product price
      - `url` string — Link to the product page
      - `imageUrl` string — Link to the product image
      - `description` string — Short description of the product

## Response `200`

## Other responses

- `400` — Bad request
- `429` — Too many requests

---

[API](https://skmtc.net/esputnik/apis/esputnik-com.md) · [All operations](https://skmtc.net/esputnik/apis/esputnik-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esputnik/esputnik-com/versions/1c4afd7ba72a/schema)