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

# Changes to Get Person

`GET /v1/merchants/{merchant_code}/persons/{person_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 53 revisions.

- **2026-06-18** `89d32e0b22e2` — 2 breaking, 2 info
- **2026-04-27** `b54086fdb4cc` — 1 breaking, 2 info
- **2026-04-13** `d06724d996eb` — 1 info
- **2026-02-19** `62e8baa4ac73` — 2 breaking, 14 info
- **2026-02-07** `5818ed9898e1` — 2 info
- **2025-11-12** `d32eef8a3bd2` — 1 info
- **2025-11-06** `cf6aa1c16447` — 2 info
- **2025-10-29** `4dc4b073a6a9` — 1 info

## Changes

- **2026-06-18** `89d32e0b22e2` — 2 breaking, 2 info
  - the `allOf[#/components/schemas/BasePerson]/identifiers/items/value` response property's maxLength was increased from `30` to `128` for the response status `200`
  - the `allOf[#/components/schemas/BasePerson]/address/street_address` response property's minItems was decreased from `1` to `0` for the response status `200`
  - the `allOf[#/components/schemas/BasePerson]/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `allOf[#/components/schemas/BasePerson]/citizenship` response's property pattern `^[A-Z]{2}$` was added for the status `200`
- **2026-04-27** `b54086fdb4cc` — 1 breaking, 2 info
  - the `allOf[#/components/schemas/BasePerson]/identifiers/items/ref` response property's maxLength was unset from `32` for the response status `200`
  - the `allOf[#/components/schemas/BasePerson]/address/country` response's property pattern `^[A-Z]{2}$` was removed for the status `200`
  - the `allOf[#/components/schemas/BasePerson]/citizenship` response's property pattern `^[A-Z]{2}$` was removed for the status `200`
- **2026-04-13** `d06724d996eb` — 1 info
  - removed the non-success response with the status `500`
- **2026-02-19** `62e8baa4ac73` — 2 breaking, 14 info
  - the response's body type changed from no type to `object` for status `404`
  - the response's body type changed from no type to `object` for status `500`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `500`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `404`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `500`
  - added the optional property `detail` to the response with the `404` status
  - added the optional property `detail` to the response with the `500` status
  - added the optional property `instance` to the response with the `404` status
  - added the optional property `instance` to the response with the `500` status
  - added the optional property `status` to the response with the `404` status
  - added the optional property `status` to the response with the `500` status
  - added the optional property `title` to the response with the `404` status
  - added the optional property `title` to the response with the `500` status
  - added the required property `type` to the response with the `404` status
  - added the required property `type` to the response with the `500` status
- **2026-02-07** `5818ed9898e1` — 2 info
  - the `allOf[#/components/schemas/BasePerson]/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `allOf[#/components/schemas/BasePerson]/citizenship` 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-11-06** `cf6aa1c16447` — 2 info
  - added the optional property `allOf[#/components/schemas/BasePerson]/country_of_residence` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/BasePerson]/nationality` to the response with the `200` status
- **2025-10-29** `4dc4b073a6a9` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/sumup/apis/sumup-rest-api/docs/v1/merchants/:merchant_code/persons/:person_id/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/persons/:person_id/get)