---
title: "Changes to List contacts"
method: GET
path: "/contacts"
---

# Changes to List contacts

`GET /contacts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-11-05** `cf0885e90d5a`: 10 warning
- **2026-11-03** `fe500ab59b3b`: 6 breaking, 20 warning, 13 info

## Changes

- **2026-11-05** `cf0885e90d5a`: 10 warning
  - added the new `forbidden` enum value to the `error/code` response property for the response status `401`
  - added the new `forbidden` enum value to the `error/code` response property for the response status `403`
  - added the new `forbidden` enum value to the `error/code` response property for the response status `409`
  - added the new `forbidden` enum value to the `error/code` response property for the response status `422`
  - added the new `forbidden` enum value to the `error/code` response property for the response status `429`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `401`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `403`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `409`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `422`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `429`
- **2026-11-03** `fe500ab59b3b`: 6 breaking, 20 warning, 13 info
  - for the `query` request parameter `per_page`, default value was changed from `25` to `40`
  - for the `query` request parameter `per_page`, the min was increased from `1.00` to `10.00`
  - the response property `data/items/email` became nullable for the status `200`
  - the response property `data/items/first_name` became nullable for the status `200`
  - the response property `data/items/last_name` became nullable for the status `200`
  - the response property `data/items/phone_number` became nullable for the status `200`
  - added the new `api_access_required` enum value to the `error/code` response property for the response status `401`
  - added the new `api_access_required` enum value to the `error/code` response property for the response status `403`
  - added the new `api_access_required` enum value to the `error/code` response property for the response status `422`
  - added the new `api_access_required` enum value to the `error/code` response property for the response status `429`
  - added the new `contacts_not_ready` enum value to the `error/code` response property for the response status `401`
  - added the new `contacts_not_ready` enum value to the `error/code` response property for the response status `403`
  - added the new `contacts_not_ready` enum value to the `error/code` response property for the response status `422`
  - added the new `contacts_not_ready` enum value to the `error/code` response property for the response status `429`
  - added the new `no_connected_store` enum value to the `error/code` response property for the response status `401`
  - added the new `no_connected_store` enum value to the `error/code` response property for the response status `403`
  - added the new `no_connected_store` enum value to the `error/code` response property for the response status `422`
  - added the new `no_connected_store` enum value to the `error/code` response property for the response status `429`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `401`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `403`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `422`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `429`
  - added the new `store_unavailable` enum value to the `error/code` response property for the response status `401`
  - added the new `store_unavailable` enum value to the `error/code` response property for the response status `403`
  - added the new `store_unavailable` enum value to the `error/code` response property for the response status `422`
  - added the new `store_unavailable` enum value to the `error/code` response property for the response status `429`
  - added the new optional `header` request parameter `Privy-Account-Id`
  - added the new optional `query` request parameter `created_after`
  - added the new optional `query` request parameter `created_before`
  - added the new optional `query` request parameter `import_id`
  - added the new optional `query` request parameter `updated_after`
  - added the new optional `query` request parameter `updated_before`
  - added the non-success response with the status `409`
  - added the optional property `data/items/email_consent_at` to the response with the `200` status
  - added the optional property `data/items/import_ids` to the response with the `200` status
  - added the optional property `data/items/imported` to the response with the `200` status
  - added the optional property `data/items/sms_consent_at` to the response with the `200` status
  - added the optional property `data/items/source` to the response with the `200` status
  - added the optional property `data/items/source_type` to the response with the `200` status

---

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