Search invoices

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

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 invoices.

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

Changed in 17 of the 51 revisions of this API.7913260

Jul 1, 2026e24a26de418848See the full diff
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /////////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ///////////////////////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property //////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////////// from the response with the status
  response-required-property-removed
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
Jan 27, 2026cf859d5a7d242See the full diff
- ○
  added to the /////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the /////////// response property anyOf list for the response status
  response-property-any-of-removed
Dec 11, 2025f83e937202592See the full diff
- ▲
  the //////// response property's maxLength was unset from 5000 for the response status
  response-property-max-length-unset
- ▲
  the //////// response's property type changed from string to no type for status
  response-property-type-changed
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
Nov 5, 202562e8dc4ed8695See the full diff
- ○
  added the optional property //////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
Oct 22, 20251e483c60b4805See the full diff
- ○
  added the optional property //////////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
Sep 25, 2025eb1ac21ec19c34See the full diff
- ●
  removed the optional property //////////////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////////////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /////////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //////////////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////////////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ///////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //////////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  added the new prevented enum value to the //////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the /////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ///////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ///////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the //////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ///////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the /////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the /////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the //////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the //////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the //////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the //////// response property for the response status
  response-property-enum-value-added
- ●
  added the new prevented enum value to the //////// response property for the response status
  response-property-enum-value-added
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
Aug 19, 20257b79777e9bbd14See the full diff
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
Jul 22, 2025c4dc6dbe947e7See the full diff
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
Apr 21, 20259a22ca25ad2f221See the full diff
- ▲
  the response property ///////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ///////// became optional for the status
  response-property-became-optional
- ●
  added the new affirm enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new aw_tin enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new aw_tin enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new az_tin enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new az_tin enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new bd_bin enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new bd_bin enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new bf_ifu enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new bf_ifu enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new bj_ifu enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new bj_ifu enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new cm_niu enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new cm_niu enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new cv_nif enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new cv_nif enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new et_tin enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new et_tin enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new kg_tin enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new kg_tin enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new la_tin enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new la_tin enum value to the //// response property for the response status
  response-property-enum-value-added
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 27, 20250d3b125ef9f32See the full diff
- ▲
  the ////// response property's maxLength was unset from 5000 for the response status
  response-property-max-length-unset
- ▲
  the ////// response's property type changed from string to no type for status
  response-property-type-changed
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.

Of the 51 revisions, 14 have no diff computed and 6 have a changelog that could not be searched.

Full history (17 revisions)