Sample - Stripe API
GET/v1/terminal/configurations

List Terminal configurations

Lists Terminal configurations available for readers. Use cursor parameters to page through configurations and is_account_default to filter for account-default or non-default configurations. Results include pagination metadata and configuration objects.

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

5 parameters
ending_beforestringoptional
A configuration object ID that defines the end of the page when retrieving earlier results.
expandarray<string>optional
Fields to expand in each configuration in the response. Each value must not exceed 5000 characters.
is_account_defaultbooleanoptional
Filter configurations by whether they are the account default.
limitintegeroptional
The number of configurations to return. Must be between 1 and 100 and defaults to 10 when omitted.
starting_afterstringoptional
A configuration object ID that defines the start of the page when retrieving later results.

2 status codes
200Returns a list object containing Terminal configuration objects in `data`, a `has_more` pagination flag, the list object type, and the request URL.
dataarray<Configuration>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.
defaultReturns an error object containing an error type and, when available, details such as a message, parameter, code, or documentation URL.
errorobjectrequired

Error handling

limit must be between 1 and 100 when provided, and defaults to 10 when omitted. Use starting_after or ending_before with configuration object IDs to navigate the list; each expand value must not exceed 5000 characters.