--- title: "Changes to List customers" method: GET path: "/customers" --- # Changes to List customers `GET /customers` > Every recorded change to this operation, newest first. ## Timeline Changed in 5 of 19 revisions. - **2026-07-09** (v1) `e1ac347eb3c5`: 1 info - **2026-02-02** (v1) `9ba8be0f2006`: 13 breaking, 1 warning, 29 info - **2025-04-25** (v1) `c4b1322e66ca`: 1 breaking - **2025-03-07** (v1) `a3359d7731fd`: 5 breaking, 1 info - **2024-02-19** (v1) `a4a4068ff792`: 9 breaking, 2 warning, 7 info ## Changes - **2026-07-09** (v1) `e1ac347eb3c5`: 1 info - added the new optional `header` request parameter `Skip-Count` - **2026-02-02** (v1) `9ba8be0f2006`: 13 breaking, 1 warning, 29 info - for the `query` request parameter `status`, default value `active` was added - the `data/items/email` response property's maxLength was unset from `320` for the response status `200` - the `data/items/email` response property's minLength was decreased from `1` to `0` for the response status `200` - the `data/items/created_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200` - the `data/items/email` response's property type changed from `string` to no type, and format from `email` to no format for status `200` - the `data/items/id` response's property type changed from `string` to no type for status `200` - the `data/items/status` response's property type changed from `string` to no type for status `200` - the `data/items/updated_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200` - the `error` response's property type changed from `object` to no type for status `default` - removed the required property `error/code` from the response with the `default` status - removed the required property `error/detail` from the response with the `default` status - removed the required property `error/documentation_url` from the response with the `default` status - removed the required property `error/type` from the response with the `default` status - removed the optional property `error/errors` from the response with the `default` status - the response optional property `data/items/import_meta` became not read-only for the status `200` - the response optional property `data/items/marketing_consent` became not read-only for the status `200` - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default` - added `#/components/schemas/CreatedAt` to the `data/items/created_at` response property `allOf` list for the response status `200` - added `#/components/schemas/CustomerId` to the `data/items/id` response property `allOf` list for the response status `200` - added `#/components/schemas/Email` to the `data/items/email` response property `allOf` list for the response status `200` - added `#/components/schemas/Status` to the `data/items/status` response property `allOf` list for the response status `200` - added `#/components/schemas/UpdatedAt` to the `data/items/updated_at` response property `allOf` list for the response status `200` - added `#/components/schemas/CustomData, subschema #2` to the `data/items/custom_data` response property `anyOf` list for the response status `200` - added `#/components/schemas/ImportMeta, subschema #2` to the `data/items/import_meta` response property `anyOf` list for the response status `200` - added `#/components/schemas/Name, subschema #2` to the `data/items/name` response property `anyOf` list for the response status `200` - the response property `data/items/created_at` became required for the status `200` - the response property `data/items/custom_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/import_meta` became required for the status `200` - the response property `data/items/locale` became required for the status `200` - the response property `data/items/marketing_consent` became required for the status `200` - the response property `data/items/name` became required for the status `200` - the response property `data/items/status` became required for the status `200` - the response property `data/items/updated_at` became required for the status `200` - the response property `error` became required for the status `default` - the response property `meta` became required for the status `default` - removed the `active` enum value from the `data/items/status` response property for the response status `200` - removed the `archived` enum value from the `data/items/status` response property for the response status `200` - removed `#/components/schemas/custom_data, subschema #2` from the `data/items/custom_data` response property `oneOf` list for the response status `200` - …3 more - **2025-04-25** (v1) `c4b1322e66ca`: 1 breaking - the response property `meta/pagination/estimated_total` became optional for the status `200` - **2025-03-07** (v1) `a3359d7731fd`: 5 breaking, 1 info - the `data/items/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200` - the `data/items/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200` - added `#/components/schemas/external_id, subschema #2` to the `data/items/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200` - added `#/components/schemas/migration_provider_public` to the `data/items/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200` - the `data/items/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200` - the response required property `data/items/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - **2024-02-19** (v1) `a4a4068ff792`: 9 breaking, 2 warning, 7 info - for the `query` request parameter `per_page`, default value was changed from `10` to `50` - the `data/items/name` response property's maxLength was unset from `1024` for the response status `200` - added `#/components/schemas/custom_data, subschema #2` to the `data/items/custom_data` response property `oneOf` list for the response status `200` - added `#/components/schemas/import_meta, subschema #2` to the `data/items/import_meta` response property `oneOf` list for the response status `200` - added `#/components/schemas/name, subschema #2` to the `data/items/name` response property `oneOf` list for the response status `200` - the `data/items/custom_data` response's property type changed from `object, null` to no type for status `200` - the `data/items/import_meta` response's property type changed from `object, null` to no type for status `200` - the `data/items/name` response's property type changed from `string, null` to no type for status `200` - removed the required property `data/items/import_meta/imported_from` from the response with the `200` status - for the `query` request parameter `per_page`, the max was set to `200.00` - removed the optional property `data/items/import_meta/external_id` from the response with the `200` status - for the `query` request parameter `email`, the format of property `items/` was generalized from `email` to no format - removed the non-success response with the status `401` - removed the non-success response with the status `403` - removed the non-success response with the status `404` - removed the non-success response with the status `500` - the `status` response's property default value `active` was added for the status `200` - the `per_page` response's property default value `10` was removed for the status `200` --- [Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/customers/get.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/customers/get)