---
title: "Changes to Query customers"
method: POST
path: "/customers/search"
---

# Changes to Query customers

`POST /customers/search`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 12 revisions.

- **2026-06-29** `cef2964c102c` — 2 info
- **2026-05-18** `f62d8a5fe7cf` — 4 warning
- **2026-05-18** `0cb3425d6580` — 1 info
- **2026-04-06** `4ded3711f401` — 7 warning, 8 info
- **2026-04-04** `d1860fe0ee67` — 2 breaking, 1 info

## Changes

- **2026-06-29** `cef2964c102c` — 2 info
  - added the optional property `items/items/integrations/items/metadata` to the response with the `200` status
  - added the optional property `items/items/timezone` to the response with the `200` status
- **2026-05-18** `f62d8a5fe7cf` — 4 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `500` status
  - added the new `too_many_requests` enum value to the `code` response property for the response status `400`
  - added the new `too_many_requests` enum value to the `code` response property for the response status `500`
- **2026-05-18** `0cb3425d6580` — 1 info
  - added the new optional request property `metadata`
- **2026-04-06** `4ded3711f401` — 7 warning, 8 info
  - removed the request property `parent_customer_ids`
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `error` from the response with the `500` status
  - removed the optional property `items/items/parent_customer` from the response with the `200` status
  - removed the optional property `items/items/parent_customer_id` from the response with the `200` status
  - removed the optional property `success` from the response with the `400` status
  - removed the optional property `success` from the response with the `500` status
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `500` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `500` status
  - added the optional property `http_status_code` to the response with the `400` status
  - added the optional property `http_status_code` to the response with the `500` status
  - added the optional property `message` to the response with the `400` status
  - added the optional property `message` to the response with the `500` status
- **2026-04-04** `d1860fe0ee67` — 2 breaking, 1 info
  - the `end_time` request property type/format changed from `string`/`` to `string`/`date-time`
  - the `start_time` request property type/format changed from `string`/`` to `string`/`date-time`
  - added the optional property `items/items/integrations` to the response with the `200` status

---

[Operation](https://skmtc.dev/flexprice/apis/flexprice-api-2/docs/customers/search/post.md) · [API](https://skmtc.dev/flexprice/apis/flexprice-api-2.md) · [Page](https://skmtc.dev/flexprice/apis/flexprice-api-2/changes/customers/search/post)