Search customers

Changed on Sep 29, 2026

Search for customers you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.

get/v1/customers/search

Request

Base URL: https://api.stripe.com
URL: https://api.stripe.com/v1/customers/search
Auth: one of:
- HTTP basic
- HTTP bearer

Query parameters

expandstring[]

Specifies which fields in the response should be expanded.

limitinteger

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

pagestring

A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.

querystring required

The search query string. See search query language and the list of supported query fields for customers.

Response

Successful response.

has_moreboolean required

next_pagestring nullable

object'search_result' required

String representing the object's type. Objects of the same type share the same value.

total_countinteger

The total number of objects that match the query, only accurate up to 10,000.

urlstring required

Changes

Sep 29, 20267cff4cc46d06 Revision changes
- warning
  added the new final_payment_failure enum value to the //////// response property for the response status
- warning
  added the new first_payment_failure enum value to the //////// response property for the response status
Jul 1, 2026e24a26de4188 Revision changes
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ////////////////// from the response with the status
- breaking
  removed the required property //////////////// from the response with the status
- breaking
  removed the required property //////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property //////////////////// from the response with the status
- breaking
  removed the required property ////////////////// from the response with the status
- breaking
  removed the required property ////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property //////////////////// from the response with the status
- breaking
  removed the required property //////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property //////////////////// from the response with the status
- breaking
  removed the required property ////////////////// from the response with the status
- breaking
  removed the required property ////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property /////////////////// from the response with the status
- breaking
  removed the required property /////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property //////////// from the response with the status
- breaking
  removed the required property ////////// from the response with the status
- breaking
  removed the required property ////////// from the response with the status
This list may be incomplete.

Some revisions have not been checked yet.

Operation history (4 revisions)