---
title: "Changes to List Identities"
method: GET
path: "/identities"
---

# Changes to List Identities

`GET /identities`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 27 revisions.

- **2026-10-14** `adb3c5058a74`: 2 info
- **2026-08-22** `7919e33b4853`: 2 breaking, 12 info

## Changes

- **2026-10-14** `adb3c5058a74`: 2 info
  - added the new optional `query` request parameter `identity_role`
  - added the new optional `query` request parameter `type`
- **2026-08-22** `7919e33b4853`: 2 breaking, 12 info
  - the response property `_embedded/identities/items/entity/personal_address` became nullable for the status `200`
  - the `_embedded/identities/items/entity/personal_address` response's property type changed from no type to `object` for status `200`
  - added the optional property `_embedded/identities/items/additional_underwriting_data/annual_card_volume` to the response with the `200` status
  - added the optional property `_embedded/identities/items/entity/business_tax_id_fingerprint` to the response with the `200` status
  - added the optional property `_embedded/identities/items/entity/business_tax_id_provided` to the response with the `200` status
  - added the optional property `_embedded/identities/items/entity/personal_address/line2` to the response with the `200` status
  - added the optional property `_embedded/identities/items/entity/tax_id_fingerprint` to the response with the `200` status
  - added the optional property `_embedded/identities/items/entity/tax_id_provided` to the response with the `200` status
  - removed `#/components/schemas/address` from the `_embedded/identities/items/entity/personal_address` response property `allOf` list for the response status `200`
  - added the required property `_embedded/identities/items/entity/personal_address/city` to the response with the `200` status
  - added the required property `_embedded/identities/items/entity/personal_address/country` to the response with the `200` status
  - added the required property `_embedded/identities/items/entity/personal_address/line1` to the response with the `200` status
  - added the required property `_embedded/identities/items/entity/personal_address/postal_code` to the response with the `200` status
  - added the required property `_embedded/identities/items/entity/personal_address/region` to the response with the `200` status

---

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