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
Key | Datatype | Required | Description |
---|---|---|---|
expand[0] | string | Specifies which fields in the response should be expanded. | |
expand[1] | string | Specifies which fields in the response should be expanded. | |
limit | string | A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. | |
page | string | 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. | |
query | string |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
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"}