---
title: "Get Single Order"
method: GET
path: "/orders/{orderId}"
tags: ["Orders"]
---

# Get Single Order

`GET /orders/{orderId}`

## Request

- Base URL: `https://api.kyckr.com/v2`
- URL: `https://api.kyckr.com/v2/orders/{orderId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api/docs/orders/:orderId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a single order and retrieval details

## Response `200`

OK

- object
  - `orderId` string: The related orderId.
  - `correlationId` string: The related correlationId to this request, for support purposes.
  - `customerReference` string: A customer provided reference, which appears in the order list.
  - `timeStamp` string, date-time: The UTC time at which the request occurred.
  - `details` string: The response status details for the current request.
  - `cost` Cost: Cost of an item
    - `type` 'credit' | 'lite'
    - `value` number
  - `links` object
    - `self` string, uri-reference
  - `data` OrderDetails
    - `orderId` integer
    - `orderDate` string, date-time
    - `customerReference` string: Optional reference supplied by user
    - `status` 'Success' | 'Pending' | 'Failed': Status of order
    - `failureReason` string: Why the order could not be fulfilled. Present only when `status` is `Failed`.
    - `cost` Cost: Cost of an item
      - `type` 'credit' | 'lite'
      - `value` number
    - `user` string, uri-reference: URL reference to user who placed order
    - `productDetails` object: Product detail fields from the order.
      - `productName` string: The name of the ordered product
      - `productId` string: The unique identifier of the ordered product
      - `productCategory` string: The category of the ordered product
    - `companyDetails` object: The name of the company referred to in the order
      - `companyName` string: The number of the company referred to in the order
      - `companyNumber` string: The number of the company referred to in the order
      - `kyckrID` string: The Kyckr ID of the company referred to in the order
    - `links` object
      - `data` string, uri-reference: URL reference to structured data format
      - `document` string, uri-reference: URL reference to document format

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-11-03** `43819cfabfed`: 6 breaking, 2 warning, 2 info
  - the `allOf[subschema #1: BaseResponse]/orderId` response's property type changed from `number` to `string` for status `200`
  - the `allOf[subschema #1: BaseResponse]/orderId` response's property type changed from `number` to `string` for status `400`
  - the `allOf[subschema #1: BaseResponse]/orderId` response's property type changed from `number` to `string` for status `401`
  - the `allOf[subschema #1: BaseResponse]/orderId` response's property type changed from `number` to `string` for status `403`
  - …6 more

[Operation history](https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api/changes/orders/:orderId/get.md)

---

[API](https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api.md) - [All operations](https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api/revisions/f7cb3dcbfb13?raw)