---
title: "Changes to Get Merchant"
method: GET
path: "/v1/merchants/{merchant_code}"
---

# Changes to Get Merchant

`GET /v1/merchants/{merchant_code}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 79 revisions.

- **2026-10-14** `0f66b0a52002`: 12 breaking, 32 warning, 7 info
- **2026-09-04** `9d793febdaeb`: 1 warning, 3 info
- **2026-07-10** `c75ca16e1e44`: 1 info
- **2026-06-18** `89d32e0b22e2`: 5 breaking, 4 info
- **2026-04-27** `b54086fdb4cc`: 4 info
- **2026-03-30** `d9ef99f300c4`: 1 breaking
- **2026-02-19** `62e8baa4ac73`: 1 breaking, 7 info
- **2026-02-07** `5818ed9898e1`: 4 info
- **2025-11-12** `d32eef8a3bd2`: 1 info
- **2025-10-29** `4dc4b073a6a9`: 1 info

## Changes

- **2026-10-14** `0f66b0a52002`: 12 breaking, 32 warning, 7 info
  - the `allOf[subschema #1]/business_profile/address/country` response property's maxLength was unset from `2` for the response status `200`
  - the `allOf[subschema #1]/company/legal_type` response property's maxLength was unset from `64` for the response status `200`
  - the `allOf[subschema #1]/company/phone_number` response property's maxLength was unset from `16` for the response status `200`
  - the `allOf[subschema #1]/business_profile/address/country` response property's minLength was decreased from `2` to `0` for the response status `200`
  - the `allOf[subschema #1]/company/legal_type` response property's minLength was decreased from `4` to `0` for the response status `200`
  - the `allOf[subschema #1]/business_profile/address/country` response's property type changed from `string` to no type for status `200`
  - the `allOf[subschema #1]/company/address` response's property type changed from `object` to no type for status `200`
  - the `allOf[subschema #1]/company/legal_type` response's property type changed from `string` to no type for status `200`
  - the `allOf[subschema #1]/company/phone_number` response's property type changed from `string` to no type for status `200`
  - the `allOf[subschema #1]/company/trading_address` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[subschema #1]/company/address/country` from the response with the `200` status
  - removed the required property `allOf[subschema #1]/company/trading_address/country` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/autonomous_community` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/city` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/commune` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/county` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/department` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/district` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/eircode` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/municipality` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/neighborhood` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/post_code` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/post_town` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/province` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/region` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/state` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/street_address` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/address/zip_code` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/autonomous_community` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/city` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/commune` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/county` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/department` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/district` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/eircode` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/municipality` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/neighborhood` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/post_code` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/post_town` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/company/trading_address/province` from the response with the `200` status
  - …11 more
- **2026-09-04** `9d793febdaeb`: 1 warning, 3 info
  - deleted the `query` request parameter `version`
  - the `allOf[subschema #1]/company/identifiers/items/ref` response's property pattern `^[a-z]{2}\.[a-z_]+$` was added for the status `200`
  - the `allOf[subschema #1]/company/legal_type` response's property pattern `^[a-z]{2}\.[a-z_]+$` was added for the status `200`
  - the `allOf[subschema #1]/business_profile/dynamic_descriptor` response's property pattern was changed from `^[a-zA-Z0-9 \-+\'_.]{0,30}$` to `^[a-zA-Z0-9 +'_.-]+$` for the status `200`
- **2026-07-10** `c75ca16e1e44`: 1 info
  - added the optional property `allOf[subschema #1]/business_profile/branding/footer_text` to the response with the `200` status
- **2026-06-18** `89d32e0b22e2`: 5 breaking, 4 info
  - the `allOf[subschema #1]/business_profile/address/street_address` response property's minItems was decreased from `1` to `0` for the response status `200`
  - the `allOf[subschema #1]/company/address/street_address` response property's minItems was decreased from `1` to `0` for the response status `200`
  - the `allOf[subschema #1]/company/trading_address/street_address` response property's minItems was decreased from `1` to `0` for the response status `200`
  - the `allOf[subschema #1]/business_profile/website` response's property format changed from `uri` to no format for status `200`
  - the `allOf[subschema #1]/company/website` response's property format changed from `uri` to no format for status `200`
  - the `allOf[subschema #1]/business_profile/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `allOf[subschema #1]/company/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `allOf[subschema #1]/company/trading_address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `allOf[subschema #1]/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
- **2026-04-27** `b54086fdb4cc`: 4 info
  - the `allOf[subschema #1]/business_profile/address/country` response's property pattern `^[A-Z]{2}$` was removed for the status `200`
  - the `allOf[subschema #1]/company/address/country` response's property pattern `^[A-Z]{2}$` was removed for the status `200`
  - the `allOf[subschema #1]/company/trading_address/country` response's property pattern `^[A-Z]{2}$` was removed for the status `200`
  - the `allOf[subschema #1]/country` response's property pattern `^[A-Z]{2}$` was removed for the status `200`
- **2026-03-30** `d9ef99f300c4`: 1 breaking
  - the `allOf[subschema #1]/avatar` response's property format changed from `url` to `uri` for status `200`
- **2026-02-19** `62e8baa4ac73`: 1 breaking, 7 info
  - the response's body type changed from no type to `object` for status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `404`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `404`
  - added the optional property `detail` to the response with the `404` status
  - added the optional property `instance` to the response with the `404` status
  - added the optional property `status` to the response with the `404` status
  - added the optional property `title` to the response with the `404` status
  - added the required property `type` to the response with the `404` status
- **2026-02-07** `5818ed9898e1`: 4 info
  - the `allOf[subschema #1]/business_profile/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `allOf[subschema #1]/company/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `allOf[subschema #1]/company/trading_address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `allOf[subschema #1]/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
- **2025-11-12** `d32eef8a3bd2`: 1 info
  - the security scope `merchant.read` was removed from the endpoint's security scheme `oauth2`
- **2025-10-29** `4dc4b073a6a9`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/sumup/apis/sumup-rest-api/docs/v1/merchants/:merchant_code/get.md) - [API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) - [Page](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v1/merchants/:merchant_code/get)
