---
title: "Changes to GET /deals/{deal_id}"
method: GET
path: "/deals/{deal_id}"
---

# Changes to GET /deals/{deal_id}

`GET /deals/{deal_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 5 revisions.

- **2026-02-14** `fe24d3dfadad` — 2 breaking, 28 info

## Changes

- **2026-02-14** `fe24d3dfadad` — 2 breaking, 28 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - the `allOf[#/components/schemas/BaseDeal]/type` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - api operation id `Deals_retrieve` was added
  - for the `path` request parameter `deal_id`, the minLength was decreased from `36` to `0`
  - removed `subschema #2` from the response body `allOf` list for the response status `200`
  - removed `subschema #2` from the response body `allOf` list for the response status `400`
  - removed `subschema #2` from the response body `allOf` list for the response status `401`
  - removed `subschema #2` from the response body `allOf` list for the response status `403`
  - removed `subschema #2` from the response body `allOf` list for the response status `404`
  - removed `subschema #2` from the response body `allOf` list for the response status `429`
  - removed `subschema #2` from the response body `allOf` list for the response status `500`
  - added the optional property `description` to the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
  - added `#/components/schemas/DealType` to the `allOf[#/components/schemas/BaseDeal]/type` response property `allOf` list for the response status `200`
  - removed discriminator from `allOf[#/components/schemas/BaseDeal]/` response property for the response status `200`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `400`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `401`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `403`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `404`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `429`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `500`
  - removed the `safe_deal` enum value from the `allOf[#/components/schemas/BaseDeal]/type` response property for the response status `200`
  - added the required property `balance` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `expires_at` to the response with the `200` status
  - added the required property `fee_moment` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `payout_balance` to the response with the `200` status
  - added the required property `status` to the response with the `200` status
  - added the required property `test` to the response with the `200` status

---

[Operation](https://skmtc.dev/hexlet/apis/api-kassa/docs/deals/:deal_id/get.md) · [API](https://skmtc.dev/hexlet/apis/api-kassa.md) · [Page](https://skmtc.dev/hexlet/apis/api-kassa/changes/deals/:deal_id/get)
