---
title: "Changes to Retrieve a list of customers by filter"
method: GET
path: "/customers"
---

# Changes to Retrieve a list of customers by filter

`GET /customers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 43 revisions.

- **2026-11-02** `5eb8e7e1d53c`: 7 info
- **2026-10-20** `1a2e874091e2`: 1 info
- **2026-10-08** `a47581aae00a`: 1 warning
- **2026-10-07** `b277963edc77`: 3 warning, 4 info
- **2026-09-11** `d034b7b4c205`: 1 warning
- **2026-09-10** `b8b383ff55df`: 2 info
- **2026-09-05** `287951a08275`: 2 breaking
- **2026-08-29** `53d29f0850e0`: 2 warning, 1 info
- **2026-08-27** `94b675108817`: 1 info

## Changes

- **2026-11-02** `5eb8e7e1d53c`: 7 info
  - added the optional property `customers/items/addresses/items/addressLine2` to the response with the `200` status
  - added the optional property `customers/items/addresses/items/region` to the response with the `200` status
  - added the optional property `customers/items/billerBankAccount/accountHolderAddress/addressLine2` to the response with the `200` status
  - added the optional property `customers/items/billerBankAccount/accountHolderAddress/region` to the response with the `200` status
  - added the optional property `customers/items/billerBankAccount/bankAddress/addressLine2` to the response with the `200` status
  - added the optional property `customers/items/billerBankAccount/bankAddress/region` to the response with the `200` status
  - added the optional property `customers/items/directDebitMandate/paymentDetails` to the response with the `200` status
- **2026-10-20** `1a2e874091e2`: 1 info
  - added the optional property `customers/items/directDebitMandate/scheme` to the response with the `200` status
- **2026-10-08** `a47581aae00a`: 1 warning
  - added the new `DEACTIVATED_BY_PAYMENT_PROVIDER` enum value to the `customers/items/directDebitMandate/statusReasonCode` response property for the response status `200`
- **2026-10-07** `b277963edc77`: 3 warning, 4 info
  - removed the optional property `customers/items/addresses/items/id` from the response with the `200` status
  - removed the optional property `customers/items/billerBankAccount/accountHolderAddress/id` from the response with the `200` status
  - removed the optional property `customers/items/billerBankAccount/bankAddress/id` from the response with the `200` status
  - the response property `customers/items/addresses/items/addressLine1` became required for the status `200`
  - the response property `customers/items/addresses/items/city` became required for the status `200`
  - the response property `customers/items/addresses/items/country` became required for the status `200`
  - the response property `customers/items/addresses/items/postalCode` became required for the status `200`
- **2026-09-11** `d034b7b4c205`: 1 warning
  - removed the optional property `customers/items/directDebitMandate/mandateContactId` from the response with the `200` status
- **2026-09-10** `b8b383ff55df`: 2 info
  - added the optional property `customers/items/directDebitMandate/personId` to the response with the `200` status
  - response property `customers/items/directDebitMandate/mandateContactId` deprecated
- **2026-09-05** `287951a08275`: 2 breaking
  - for the `query` request parameter `customerIds`, the format of property `items/` was specialized from no format to `uuid`
  - for the `query` request parameter `tagIds`, the format of property `items/` was specialized from no format to `uuid`
- **2026-08-29** `53d29f0850e0`: 2 warning, 1 info
  - removed the optional property `customers/items/customerAgentId` from the response with the `200` status
  - added the new `DEBIT_NOT_AUTHORIZED` enum value to the `customers/items/directDebitMandate/statusReasonCode` response property for the response status `200`
  - added the optional property `customers/items/collectionAgentId` to the response with the `200` status
- **2026-08-27** `94b675108817`: 1 info
  - added the optional property `customers/items/customerAgentId` to the response with the `200` status

---

[Operation](https://skmtc.dev/adfin/apis/adfin-api/docs/customers/get.md) - [API](https://skmtc.dev/adfin/apis/adfin-api.md) - [Page](https://skmtc.dev/adfin/apis/adfin-api/changes/customers/get)