Search customers

GET {{baseUrl}}/v1/customers/search?query=email:"{{email}}"

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.

Request Params

KeyDatatypeRequiredDescription
expand[0]stringSpecifies which fields in the response should be expanded.
expand[1]stringSpecifies which fields in the response should be expanded.
limitstringA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
pagestringA 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

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{"object":"search_result","data":[{"id":"cus_NJxjSuPZXlx5Md","object":"customer","address":null,"balance":0,"created":1675886394,"currency":null,"default_source":null,"delinquent":false,"description":null,"discount":null,"email":"jane@example.com","invoice_prefix":"5665616E","invoice_settings":{"custom_fields":null,"default_payment_method":null,"footer":null,"rendering_options":null},"livemode":false,"metadata":{},"name":"Jane Doe","next_invoice_sequence":1,"phone":null,"preferred_locales":[],"shipping":null,"tax_exempt":"none","test_clock":null}],"has_more":false,"next_page":null,"url":"/v1/customers/search"}