---
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 7 revisions.

- **2026-09-30** `4dc1e20989c8`: 12 warning
- **2026-09-29** `ef5b22b98333`: 3 breaking, 5 warning, 19 info

## Changes

- **2026-09-30** `4dc1e20989c8`: 12 warning
  - added the new `daily_limit_exceeded` enum value to the `anyOf[#/components/schemas/Error]/code` response property for the response status `403`
  - added the new `daily_limit_exceeded` enum value to the `code` response property for the response status `400`
  - added the new `daily_limit_exceeded` enum value to the `code` response property for the response status `401`
  - added the new `daily_limit_exceeded` enum value to the `code` response property for the response status `404`
  - added the new `monthly_limit_exceeded` enum value to the `anyOf[#/components/schemas/Error]/code` response property for the response status `403`
  - added the new `monthly_limit_exceeded` enum value to the `code` response property for the response status `400`
  - added the new `monthly_limit_exceeded` enum value to the `code` response property for the response status `401`
  - added the new `monthly_limit_exceeded` enum value to the `code` response property for the response status `404`
  - added the new `send_limit_exceeded` enum value to the `anyOf[#/components/schemas/Error]/code` response property for the response status `403`
  - added the new `send_limit_exceeded` enum value to the `code` response property for the response status `400`
  - added the new `send_limit_exceeded` enum value to the `code` response property for the response status `401`
  - added the new `send_limit_exceeded` enum value to the `code` response property for the response status `404`
- **2026-09-29** `ef5b22b98333`: 3 breaking, 5 warning, 19 info
  - the response property `data/items/properties` became nullable for the status `200`
  - the `data/items/email` response's property format changed from `email` to no format for status `200`
  - the `data/items/id` response's property type changed from `string` to `integer` for status `200`
  - deleted the `query` request parameter `limit`
  - removed the optional property `data/items/created_at` from the response with the `200` status
  - removed the optional property `data/items/first_name` from the response with the `200` status
  - removed the optional property `data/items/last_name` from the response with the `200` status
  - removed the optional property `pagination` from the response with the `200` status
  - added the new optional `query` request parameter `engagement_segment`
  - added the new optional `query` request parameter `per_page`
  - added the new optional `query` request parameter `unsubscribed`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the optional property `data/items/createdAt` to the response with the `200` status
  - added the optional property `data/items/engagementSegment` to the response with the `200` status
  - added the optional property `data/items/firstName` to the response with the `200` status
  - added the optional property `data/items/lastEngagedAt` to the response with the `200` status
  - added the optional property `data/items/lastName` to the response with the `200` status
  - added the optional property `data/items/updatedAt` to the response with the `200` status
  - the response property `data` became required for the status `200`
  - the response property `data/items/email` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - the response property `data/items/unsubscribed` became required for the status `200`
  - added the required property `data/items/publicId` to the response with the `200` status
  - added the required property `meta` to the response with the `200` status

---

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