Sample - Stripe API
GET/v1/forwarding/requests

List forwarding requests

Lists ForwardingRequest objects. Use created to filter by creation timestamp and the cursor parameters to navigate through the list, and use expand to request expanded fields. The response contains forwarding requests and pagination metadata.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

5 parameters
createdobjectoptional
Filters requests by creation timestamp using `gt`, `gte`, `lt`, or `lte` integer values.
ending_beforestringoptional
A ForwardingRequest ID cursor for retrieving the previous page of results. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in the response. Each value can be up to 5000 characters.
limitintegeroptional
The number of requests to return. Must be between 1 and 100. Defaults to 10 when omitted.
starting_afterstringoptional
A ForwardingRequest ID cursor for retrieving the next page of results. Maximum 5000 characters.

2 status codes
200Returns a list object containing ForwardingRequest data, a `has_more` pagination flag, the list object type, and the resource URL.
dataarray<ForwardingRequest>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
Allowed:list
urlstringrequired
The URL where this list can be accessed.
defaultReturned when the request cannot be processed; the response contains an error object with an error type and related details.
errorobjectrequired

Error handling

limit must be between 1 and 100 and defaults to 10 when omitted. ending_before and starting_after must contain ForwardingRequest IDs, and each created range value must be an integer timestamp.