---
title: "Creates an order"
method: POST
path: "/orders"
tags: ["Shipper"]
---

# Creates an order

`POST /orders`

Creates an order based on the factors provided in the request body. This API endpoint can only be accessed by Shippers!

## Request body

- OrderRequest
  - `arriving` OrderRequestLocation, required
    - `name` string, required — Name of the location. Can be an internal identifier, name of the location (ex. LAX Terminal 7), etc.
    - `address` string, required — US-based addresses must include street address, suite (if applicable), state, and zip code.
  - `contacts` object[]
    - `name` string
    - `phone` string
  - `delivering` OrderRequestLocation, required
    - `name` string, required — Name of the location. Can be an internal identifier, name of the location (ex. LAX Terminal 7), etc.
    - `address` string, required — US-based addresses must include street address, suite (if applicable), state, and zip code.
  - `equipments` OrderRequestEquipments[]
    - `equipment_id` string, required
    - `_equipmentType` string, required
  - `estimated_arrival` string
  - `master_bill_of_lading` string, required
  - `movement_type` string, required — Valid entries for `movement_type` and `service_type` are `pickup` and `delivery`.
  - `ocean_carrier_scac` string — The SCAC code for an Ocean Carrier. If the SCAC code is not a known Ocean Carrier SCAC, enter `Custom`.
  - `custom_ocean_carrier_scac` string — This `custom_ocean_carrier_scac` is required when the value for `ocean_carrier_scac` is `Custom`.
  - `order_type` string, required — Valid entries for `order_type` are 'import', 'export', 'domestic', 'reposition'.
  - `originating` object, required
    - `name` string
    - `address` string
  - `reference_numbers` object[], required
    - `name` string, required
    - `value` string, required
  - `service_type` string, required
  - `shipper` string, required — `shipper` is the shipper ID.
  - `shipments_staging` OrderRequestShipmentsStaging[]
    - `weight` integer
    - `stops` OrderRequestShipmentsStagingStops[]
      - `sequence` integer
      - `action` string
      - `empty` boolean
      - `location` OrderRequestLocation
        - `name` string, required — Name of the location. Can be an internal identifier, name of the location (ex. LAX Terminal 7), etc.
        - `address` string, required — US-based addresses must include street address, suite (if applicable), state, and zip code.
      - `window_start` string, date-time
      - `window_end` string, date-time
      - `equipments` object[]
        - `equipment_id` string
        - `_equipmentType` string
  - `special_instructions` string
  - `steamship_or_railroad` string — If there is no ocean carrier associated with this shipment, `steamship_or_railroad` is required.
  - `total_weight` integer
  - `vessel_or_rail` string

## Response `200`

Status Code 200:  Successful Response - the request was successful!

- OrderResponse
  - `order` object
    - `order_id` string
    - `order_type` string
    - `reference_numbers` object[]
      - `name` string
      - `value` string
    - `service_type` string
    - `movement_type` string
    - `order_received_date` string, date-time
    - `created_at` string, date-time
    - `equipments` object[]
      - `equipment_id` string
      - `equipment_type` string
      - `type` string
      - `size` string
      - `status` string
    - `arriving` object
      - `name` string
      - `address` string
    - `delivering` object
      - `name` string
      - `address` string
    - `hazmat_class` string
    - `hazmat_packaging_group` string

## Other responses

- `400` — Status Code 400: Bad Request Response - the request header and/or body is invalid
- `500` — StatusCode 500: Internal Server Error Response - there's a problem with the Public API service

---

[API](https://skmtc.net/cargomatic/apis/cargomatic-public-api.md) · [All operations](https://skmtc.net/cargomatic/apis/cargomatic-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cargomatic/cargomatic-public-api/revisions/4aa7f4326443/schema)