--- title: "Changes to List all customers" method: GET path: "/customers" --- # Changes to List all customers `GET /customers` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 14 revisions. - **2026-11-03** `5d26657495a3`: 1 breaking, 33 info - **2026-10-16** `fce1879654d8`: 4 breaking, 7 warning, 9 info - **2026-05-20** `24e860ade740`: 1 info - **2026-01-16** `7bf10db291f4`: 2 breaking, 8 warning, 23 info - **2025-06-09** `083d895c3f8e`: 1 info - **2025-04-25** `86ccaf2d7c61`: 4 info - **2025-01-21** `36901519eb83`: 2 info - **2024-12-22** `e1b7ed77904e`: 1 breaking, 3 warning - **2024-12-09** `d7f5a2be797e`: 7 breaking, 22 warning, 1 info ## Changes - **2026-11-03** `5d26657495a3`: 1 breaking, 33 info - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/external_customer_id` became nullable for the status `200` - added the non-success response with the status `404` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/account_type` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/address_line1` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/address_line2` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_entity_code` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/city` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/country` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/currency` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/customer_type` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/email` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/external_salesforce_id` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/finalize_zero_amount_invoice` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/firstname` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/lastname` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/legal_name` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/legal_number` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/logo_url` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/metadata` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/name` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/net_payment_term` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/phone` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/shipping_address` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/skip_invoice_custom_sections` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/state` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/tax_identification_number` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/timezone` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/updated_at` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/url` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/zipcode` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/category` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/code` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/is_default` became required for the status `200` - **2026-10-16** `fce1879654d8`: 4 breaking, 7 warning, 9 info - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/document_locale` became nullable for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/invoice_grace_period` became nullable for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/payment_provider` became nullable for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/payment_provider_code` became nullable for the status `200` - added the new `SYP` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/currency` response property for the response status `200` - added the new `TND` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/currency` response property for the response status `200` - added the new `avalara` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/type` response property for the response status `200` - added the new `cashfree` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/payment_provider` response property for the response status `200` - added the new `flutterwave` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/payment_provider` response property for the response status `200` - added the new `moneyhash` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/payment_provider` response property for the response status `200` - added the new `undefined` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/payment_provider` response property for the response status `200` - added the new optional `query` request parameter `external_id` - added the enum value `SYP` to the property `items/` of the `query` request parameter `currencies[]` - added the enum value `TND` to the property `items/` of the `query` request parameter `currencies[]` - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/external_salesforce_id` to the response with the `200` status - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/category` to the response with the `200` status - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/code` to the response with the `200` status - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/is_default` to the response with the `200` status - added the optional property `customers/items/allOf[subschema #2]/taxes/items/applied_to_billing_entities_codes` to the response with the `200` status - the response property `customers/items/allOf[subschema #2]/taxes/items/description` became required for the status `200` - **2026-05-20** `24e860ade740`: 1 info - added the optional property `customers/items/allOf[subschema #2]/error_details` to the response with the `200` status - **2026-01-16** `7bf10db291f4`: 2 breaking, 8 warning, 23 info - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/sync_with_provider` became nullable for the status `200` - the response property `customers/items/allOf[subschema #2]/taxes/items/description` became nullable for the status `200` - deleted the `query` request parameter `account_type` - deleted the `query` request parameter `billing_entity_codes` - added the new `America/Nuuk` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/applicable_timezone` response property for the response status `200` - added the new `Asia/Yangon` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/applicable_timezone` response property for the response status `200` - added the new `Europe/Kyiv` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/applicable_timezone` response property for the response status `200` - added the new `hubspot` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/type` response property for the response status `200` - added the new `salesforce` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/type` response property for the response status `200` - added the new `xero` enum value to the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/type` response property for the response status `200` - added the new optional `query` request parameter `account_type[]` - added the new optional `query` request parameter `billing_entity_codes[]` - added the new optional `query` request parameter `countries[]` - added the new optional `query` request parameter `currencies[]` - added the new optional `query` request parameter `customer_type` - added the new optional `query` request parameter `has_customer_type` - added the new optional `query` request parameter `has_tax_identification_number` - added the new optional `query` request parameter `metadata[key]` - added the new optional `query` request parameter `search_term` - added the new optional `query` request parameter `states[]` - added the new optional `query` request parameter `zipcodes[]` - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/subscription_invoice_issuing_date_adjustment` to the response with the `200` status - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/billing_configuration/subscription_invoice_issuing_date_anchor` to the response with the `200` status - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/email` to the response with the `200` status - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/targeted_object` to the response with the `200` status - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/external_customer_id` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/integration_code` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/lago_id` became required for the status `200` - the response property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #2]/integration_customers/items/type` became required for the status `200` - response property `customers/items/allOf[subschema #2]/applicable_invoice_custom_sections/items/applied_to_organization` deprecated - removed the `America/Godthab` enum value from the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/applicable_timezone` response property for the response status `200` - removed the `Asia/Rangoon` enum value from the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/applicable_timezone` response property for the response status `200` - removed the `Europe/Kiev` enum value from the `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[#/components/schemas/CustomerBaseObject]/applicable_timezone` response property for the response status `200` - **2025-06-09** `083d895c3f8e`: 1 info - response property `customers/items/allOf[subschema #2]/taxes/items/applied_to_organization` deprecated - **2025-04-25** `86ccaf2d7c61`: 4 info - added the new optional `query` request parameter `account_type` - added the new optional `query` request parameter `billing_entity_codes` - added `#/components/schemas/CustomerBaseObject` to the `customers/items/allOf[#/components/schemas/CustomerObject]/` response property `allOf` list for the response status `200` - removed `subschema #1` from the `customers/items/allOf[#/components/schemas/CustomerObject]/` response property `allOf` list for the response status `200` - **2025-01-21** `36901519eb83`: 2 info - added the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/allOf[subschema #1]/skip_invoice_custom_sections` to the response with the `200` status - added the optional property `customers/items/allOf[subschema #2]/applicable_invoice_custom_sections` to the response with the `200` status - **2024-12-22** `e1b7ed77904e`: 1 breaking, 3 warning - removed the required property `customers/items/allOf[subschema #2]/taxes/items/customers_count` from the response with the `200` status - removed the optional property `customers/items/allOf[subschema #2]/taxes/items/add_ons_count` from the response with the `200` status - removed the optional property `customers/items/allOf[subschema #2]/taxes/items/charges_count` from the response with the `200` status - removed the optional property `customers/items/allOf[subschema #2]/taxes/items/plans_count` from the response with the `200` status - **2024-12-09** `d7f5a2be797e`: 7 breaking, 22 warning, 1 info - the `customers/items/allOf[#/components/schemas/CustomerObject]/` response's property type changed from `object` to no type for status `200` - removed the required property `customers/items/allOf[#/components/schemas/CustomerObject]/applicable_timezone` from the response with the `200` status - removed the required property `customers/items/allOf[#/components/schemas/CustomerObject]/created_at` from the response with the `200` status - removed the required property `customers/items/allOf[#/components/schemas/CustomerObject]/external_id` from the response with the `200` status - removed the required property `customers/items/allOf[#/components/schemas/CustomerObject]/lago_id` from the response with the `200` status - removed the required property `customers/items/allOf[#/components/schemas/CustomerObject]/sequential_id` from the response with the `200` status - removed the required property `customers/items/allOf[#/components/schemas/CustomerObject]/slug` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/address_line1` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/address_line2` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/billing_configuration` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/city` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/country` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/currency` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/email` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/integration_customers` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/legal_name` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/legal_number` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/logo_url` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/metadata` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/name` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/net_payment_term` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/phone` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/shipping_address` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/state` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/tax_identification_number` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/timezone` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/updated_at` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/url` from the response with the `200` status - removed the optional property `customers/items/allOf[#/components/schemas/CustomerObject]/zipcode` from the response with the `200` status - added `subschema #1, subschema #2` to the `customers/items/allOf[#/components/schemas/CustomerObject]/` response property `allOf` list for the response status `200` --- [Operation](https://skmtc.dev/getlago/apis/lago-api-documentation/docs/customers/get.md) - [API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) - [Page](https://skmtc.dev/getlago/apis/lago-api-documentation/changes/customers/get)