---
title: "Get a single order"
method: GET
path: "/orders/{orderId}"
tags: ["Orders"]
---

# Get a single order

`GET /orders/{orderId}`

get a specific order with all details

## Path parameters

- `orderId` integer, required

## Response `200`

OK

- GetOrder
  - `id` integer — order id from spreadconnect
  - `orderReference` integer — order reference from spreadconnect, can be changed after order updates
  - `externalOrderReference` string — external order reference from merchant (you)
  - `externalOrderName` string — external order name from merchant (you)
  - `state` 'NEW' | 'CONFIRMED' | 'PROCESSED' | 'CANCELLED' — order state
  - `orderItems` GetOrderItem[] — order items
    - `orderItemReference` integer — spreadconnect order item reference
    - `externalOrderItemReference` string — external order item reference from merchant (you)
    - `state` 'NEW' | 'CHECKED' | 'CANCELLED' | 'PRODUCTION_ISSUE' | 'IN_PRODUCTION' | 'SENT' — order item state
    - `sku` string — stock keeping unit id from spreadconnect
    - `quantity` integer — item quantity
    - `price` Price — price
      - `amount` number, required — total amount, with vat or sales tax. Must be zero or greater.
      - `taxRate` number — included vat rate in percent, only for tax type VAT
      - `taxAmount` number — included sales tax, only for tax type SALETAX
      - `currency` string, required — currency iso code (ISO 4217, 3 letters)
    - `customerPrice` CustomerPrice — customer price
      - `amount` number, required — total amount, with vat or sales tax. Must be zero or greater.
      - `currency` string, required — currency iso code (ISO 4217, 3 letters)
  - `shipping` object — shipping information
    - `address` Address — physical mailing address
      - `company` string — company name
      - `firstName` string — first name
      - `lastName` string, required — last name
      - `street` string, required — street. Must not be blank.
      - `streetAnnex` string — street annex, optional
      - `city` string, required — city name. Must not be blank.
      - `country` string, required — country code, is the ISO 3166-1 alpha-2 code of the country to deliver to, e.g. 'DE' or 'US'.
      - `state` string — state code, is the country-specific 2-letter upper-case, e.g. AL for Alabama in the USA This field is required when delivering to the USA or Canada
      - `zipCode` string, required — zip code, for some countries optional
    - `fromAddress` Address — physical mailing address
      - `company` string — company name
      - `firstName` string — first name
      - `lastName` string, required — last name
      - `street` string, required — street. Must not be blank.
      - `streetAnnex` string — street annex, optional
      - `city` string, required — city name. Must not be blank.
      - `country` string, required — country code, is the ISO 3166-1 alpha-2 code of the country to deliver to, e.g. 'DE' or 'US'.
      - `state` string — state code, is the country-specific 2-letter upper-case, e.g. AL for Alabama in the USA This field is required when delivering to the USA or Canada
      - `zipCode` string, required — zip code, for some countries optional
    - `type` ShippingType — shipping type with id, name and description
      - `id` string — shipping type id, needed for set shipping type
      - `company` string — shipping company such as DHL, UPS, DPD, USPS, DHL Express, FedEx, Post AT, Deutsche Post
      - `name` string
      - `description` string
    - `price` Price — price
      - `amount` number, required — total amount, with vat or sales tax. Must be zero or greater.
      - `taxRate` number — included vat rate in percent, only for tax type VAT
      - `taxAmount` number — included sales tax, only for tax type SALETAX
      - `currency` string, required — currency iso code (ISO 4217, 3 letters)
    - `customerPrice` CustomerPrice — customer price
      - `amount` number, required — total amount, with vat or sales tax. Must be zero or greater.
      - `currency` string, required — currency iso code (ISO 4217, 3 letters)
  - `billingAddress` Address — physical mailing address
    - `company` string — company name
    - `firstName` string — first name
    - `lastName` string, required — last name
    - `street` string, required — street. Must not be blank.
    - `streetAnnex` string — street annex, optional
    - `city` string, required — city name. Must not be blank.
    - `country` string, required — country code, is the ISO 3166-1 alpha-2 code of the country to deliver to, e.g. 'DE' or 'US'.
    - `state` string — state code, is the country-specific 2-letter upper-case, e.g. AL for Alabama in the USA This field is required when delivering to the USA or Canada
    - `zipCode` string, required — zip code, for some countries optional
  - `phone` string — Phone used for the communication with the customer.
  - `email` string — Email used for the communication with the customer.
  - `price` Price — price
    - `amount` number, required — total amount, with vat or sales tax. Must be zero or greater.
    - `taxRate` number — included vat rate in percent, only for tax type VAT
    - `taxAmount` number — included sales tax, only for tax type SALETAX
    - `currency` string, required — currency iso code (ISO 4217, 3 letters)
  - `taxType` 'SALESTAX' | 'VAT' | 'NOT_TAXABLE' — tax type, salestax or vat
  - `customerTaxType` 'SALESTAX' | 'VAT' | 'NOT_TAXABLE' — tax type, salestax or vat

## Other responses

- `404` — Order not found

---

[API](https://skmtc.net/spreadconnect/apis/spreadconnect-fulfillment-service-rest-api.md) · [All operations](https://skmtc.net/spreadconnect/apis/spreadconnect-fulfillment-service-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spreadconnect/spreadconnect-fulfillment-service-rest-api/revisions/c5159bc39a84/schema)