Search charges

Changed on Sep 25, 2026

Search for charges 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/charges/search

Request

Base URL: https://api.stripe.com
URL: https://api.stripe.com/v1/charges/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 charges.

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 25, 20268b5c2f03d4cd Revision changes
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
This list may be incomplete.
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
This list may be incomplete.

Some revisions have not been checked yet.

Operation history