---
title: "Changes to Fetch an order"
method: GET
path: "/v1/orders/{order_id}"
---

# Changes to Fetch an order

`GET /v1/orders/{order_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 24 revisions.

- **2026-11-05** `daf9b9d86161`: 1 info
- **2026-10-27** `5a8dc473d051`: 3 info
- **2026-10-22** `f961bea3a9a4`: 10 info
- **2026-10-20** `afc3c2c753ba`: 2 warning
- **2026-10-20** `016e7606e67e`: 4 info
- **2026-10-01** `6db30fc189f8`: 1 info
- **2026-09-30** `47cea4404cf5`: 16 warning
- **2026-09-09** `0696ca936043`: 8 warning
- **2026-09-01** `122c27cf38c0`: 2 info
- **2026-07-13** `1ee03e82bc45`: 1 breaking, 5 info
- **2026-06-15** `d6cd79e253a6`: 18 info

## Changes

- **2026-11-05** `daf9b9d86161`: 1 info
  - added the non-success response with the status `400`
- **2026-10-27** `5a8dc473d051`: 3 info
  - added the optional property `service_charges` to the response with the `200` status
  - added the required property `amounts/service_charge_amount` to the response with the `200` status
  - added the required property `returns/items/amounts/service_charge_amount` to the response with the `200` status
- **2026-10-22** `f961bea3a9a4`: 10 info
  - the `applied_discounts/items/percentage/anyOf[subschema #1]/` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `line_items/items/applied_discounts/items/percentage/anyOf[subschema #1]/` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `line_items/items/applied_taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `line_items/items/quantity` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `returns/items/returned_applied_discounts/items/percentage/anyOf[subschema #1]/` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `returns/items/returned_line_items/items/applied_discounts/items/percentage/anyOf[subschema #1]/` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `returns/items/returned_line_items/items/applied_taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `returns/items/returned_line_items/items/quantity` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `returns/items/returned_total_taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `total_taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
- **2026-10-20** `afc3c2c753ba`: 2 warning
  - added the new `service` enum value to the `line_items/items/item_type` response property for the response status `200`
  - added the new `service` enum value to the `returns/items/returned_line_items/items/item_type` response property for the response status `200`
- **2026-10-20** `016e7606e67e`: 4 info
  - added the required property `line_items/items/duration` to the response with the `200` status
  - added the required property `line_items/items/staff_id` to the response with the `200` status
  - added the required property `returns/items/returned_line_items/items/duration` to the response with the `200` status
  - added the required property `returns/items/returned_line_items/items/staff_id` to the response with the `200` status
- **2026-10-01** `6db30fc189f8`: 1 info
  - for the `path` request parameter `order_id`, the maxLength was increased from `100` to `201`
- **2026-09-30** `47cea4404cf5`: 16 warning
  - added the new `content_too_large` enum value to the `code` response property for the response status `401`
  - added the new `content_too_large` enum value to the `code` response property for the response status `403`
  - added the new `content_too_large` enum value to the `code` response property for the response status `404`
  - added the new `content_too_large` enum value to the `code` response property for the response status `429`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `401`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `403`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `404`
  - added the new `content_too_large` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `429`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `401`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `403`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `404`
  - added the new `unsupported_media_type` enum value to the `code` response property for the response status `429`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `401`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `403`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `404`
  - added the new `unsupported_media_type` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `429`
- **2026-09-09** `0696ca936043`: 8 warning
  - added the new `conflict` enum value to the `code` response property for the response status `401`
  - added the new `conflict` enum value to the `code` response property for the response status `403`
  - added the new `conflict` enum value to the `code` response property for the response status `404`
  - added the new `conflict` enum value to the `code` response property for the response status `429`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `401`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `403`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `404`
  - added the new `conflict` enum value to the `errors/anyOf[subschema #1]/items/code` response property for the response status `429`
- **2026-09-01** `122c27cf38c0`: 2 info
  - added the optional property `channel` to the response with the `200` status
  - added the optional property `external_id` to the response with the `200` status
- **2026-07-13** `1ee03e82bc45`: 1 breaking, 5 info
  - added the pattern `^[A-Za-z0-9:-]+$` to the `path` request parameter `order_id`
  - added the optional property `payments/items/card_machine_id` to the response with the `200` status
  - added the optional property `payments/items/refunds/items/staff_id` to the response with the `200` status
  - added the optional property `payments/items/staff_id` to the response with the `200` status
  - added the optional property `refunds/items/staff_id` to the response with the `200` status
  - added the optional property `staff_id` to the response with the `200` status
- **2026-06-15** `d6cd79e253a6`: 18 info
  - added the optional property `line_items/items/modifiers` to the response with the `200` status
  - added the optional property `payments/items/external_id` to the response with the `200` status
  - added the optional property `returns/items/returned_line_items/items/modifiers` to the response with the `200` status
  - the `applied_discounts/items/percentage/anyOf[subschema #1]/` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `line_items/items/applied_discounts/items/percentage/anyOf[subschema #1]/` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `line_items/items/applied_taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `line_items/items/quantity` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `returns/items/returned_applied_discounts/items/percentage/anyOf[subschema #1]/` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `returns/items/returned_line_items/items/applied_discounts/items/percentage/anyOf[subschema #1]/` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `returns/items/returned_line_items/items/applied_taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `returns/items/returned_line_items/items/quantity` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `returns/items/returned_total_taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - the `total_taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was added for the status `200`
  - added the required property `location_id` to the response with the `200` status
  - added the required property `payments/items/checkout_id` to the response with the `200` status
  - added the required property `payments/items/client_transaction_id` to the response with the `200` status
  - added the required property `payments/items/refunds/items/client_transaction_id` to the response with the `200` status
  - added the required property `refunds/items/client_transaction_id` to the response with the `200` status

---

[Operation](https://skmtc.dev/yoco/apis/yoco-api/docs/v1/orders/:order_id/get.md) - [API](https://skmtc.dev/yoco/apis/yoco-api.md) - [Page](https://skmtc.dev/yoco/apis/yoco-api/changes/v1/orders/:order_id/get)
