--- title: "Changes to List Persons" method: GET path: "/v1/merchants/{merchant_code}/persons" --- # Changes to List Persons `GET /v1/merchants/{merchant_code}/persons` > Every recorded change to this operation, newest first. ## Timeline Changed in 11 of 79 revisions. - **2026-11-03** `38138e18acd1`: 4 breaking, 1 warning, 23 info - **2026-10-14** `0f66b0a52002`: 9 breaking, 16 warning, 5 info - **2026-09-04** `9d793febdaeb`: 2 breaking, 1 warning, 2 info - **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-11-03** `38138e18acd1`: 4 breaking, 1 warning, 23 info - the `items/items/allOf[#/components/schemas/BasePerson]/address` response's property type changed from no type to `object` for status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/citizenship` response's property type changed from no type to `string` for status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/ownership` response's property type changed from no type to `object` for status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/phone_number` response's property type changed from no type to `string` for status `200` - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/middle_name` from the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/autonomous_community` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/city` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/commune` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/county` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/department` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/district` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/eircode` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/municipality` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/neighborhood` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/post_code` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/post_town` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/province` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/region` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/state` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/street_address` to the response with the `200` status - added the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/zip_code` to the response with the `200` status - removed `#/components/schemas/Address, subschema #1` from the `items/items/allOf[#/components/schemas/BasePerson]/address` response property `allOf` list for the response status `200` - removed `#/components/schemas/CountryCode, subschema #1` from the `items/items/allOf[#/components/schemas/BasePerson]/citizenship` response property `allOf` list for the response status `200` - removed `#/components/schemas/Ownership, subschema #1` from the `items/items/allOf[#/components/schemas/BasePerson]/ownership` response property `allOf` list for the response status `200` - removed `#/components/schemas/PhoneNumber, subschema #1` from the `items/items/allOf[#/components/schemas/BasePerson]/phone_number` response property `allOf` list for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/citizenship` response's property pattern `^[A-Z]{2}$` was added for the status `200` - added the required property `items/items/allOf[#/components/schemas/BasePerson]/address/country` to the response with the `200` status - added the required property `items/items/allOf[#/components/schemas/BasePerson]/ownership/share` to the response with the `200` status - **2026-10-14** `0f66b0a52002`: 9 breaking, 16 warning, 5 info - the `items/items/allOf[#/components/schemas/BasePerson]/citizenship` response property's maxLength was unset from `2` for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/phone_number` response property's maxLength was unset from `16` for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/citizenship` response property's minLength was decreased from `2` to `0` for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/address` response's property type changed from `object` to no type for status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/citizenship` response's property type changed from `string` to no type for status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/ownership` response's property type changed from `object` to no type for status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/phone_number` response's property type changed from `string` to no type for status `200` - removed the required property `items/items/allOf[#/components/schemas/BasePerson]/address/country` from the response with the `200` status - removed the required property `items/items/allOf[#/components/schemas/BasePerson]/ownership/share` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/autonomous_community` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/city` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/commune` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/county` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/department` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/district` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/eircode` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/municipality` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/neighborhood` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/post_code` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/post_town` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/province` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/region` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/state` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/street_address` from the response with the `200` status - removed the optional property `items/items/allOf[#/components/schemas/BasePerson]/address/zip_code` from the response with the `200` status - added `#/components/schemas/Address, subschema #1` to the `items/items/allOf[#/components/schemas/BasePerson]/address` response property `allOf` list for the response status `200` - added `#/components/schemas/CountryCode, subschema #1` to the `items/items/allOf[#/components/schemas/BasePerson]/citizenship` response property `allOf` list for the response status `200` - added `#/components/schemas/Ownership, subschema #1` to the `items/items/allOf[#/components/schemas/BasePerson]/ownership` response property `allOf` list for the response status `200` - added `#/components/schemas/PhoneNumber, subschema #1` to the `items/items/allOf[#/components/schemas/BasePerson]/phone_number` response property `allOf` list for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/citizenship` response's property pattern `^[A-Z]{2}$` was removed for the status `200` - **2026-09-04** `9d793febdaeb`: 2 breaking, 1 warning, 2 info - the `items/items/allOf[#/components/schemas/BasePerson]/country_of_residence` response property's maxLength was unset from `2` for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/country_of_residence` response property's minLength was decreased from `2` to `0` for the response status `200` - deleted the `query` request parameter `version` - the `items/items/allOf[#/components/schemas/BasePerson]/country_of_residence` response's property pattern `^[A-Z]{2}$` was added for the status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/nationality` response's property pattern `^[A-Z]{2}$` was added for the status `200` - **2026-06-18** `89d32e0b22e2`: 2 breaking, 2 info - the `items/items/allOf[#/components/schemas/BasePerson]/identifiers/items/value` response property's maxLength was increased from `30` to `128` for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/address/street_address` response property's minItems was decreased from `1` to `0` for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200` - the `items/items/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 `items/items/allOf[#/components/schemas/BasePerson]/identifiers/items/ref` response property's maxLength was unset from `32` for the response status `200` - the `items/items/allOf[#/components/schemas/BasePerson]/address/country` response's property pattern `^[A-Z]{2}$` was removed for the status `200` - the `items/items/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 `items/items/allOf[#/components/schemas/BasePerson]/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200` - the `items/items/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 `items/items/allOf[#/components/schemas/BasePerson]/country_of_residence` to the response with the `200` status - added the optional property `items/items/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/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/get)