increase-test
GET/card_validations

List card validations

Lists Card Validations used to validate a card and its cardholder before sending funds to or pulling funds from a card. Use the filters to narrow results by account, creation time, status, or idempotency key. Results are paginated and include a next_cursor value when another page is available.

9 parameters
cursorstringoptional
Pagination cursor identifying the position after which to return entries.
limitintegeroptional
Maximum number of Card Validations to return. Must be at least 1 and no greater than 100. Defaults to 100 when omitted.
Default:100
account_idstringoptional
Filter results to Card Validations belonging to this Account.
created_at.afterstringoptional
Return results created after this ISO 8601 timestamp.
created_at.beforestringoptional
Return results created before this ISO 8601 timestamp.
created_at.on_or_afterstringoptional
Return results created at or after this ISO 8601 timestamp.
created_at.on_or_beforestringoptional
Return results created at or before this ISO 8601 timestamp.
status.inarray<string>optional
Filter by status using a comma-delimited list: `requires_attention`, `pending_submission`, `submitted`, `complete`, or `declined`.
idempotency_keystringoptional
Filter for the Card Validation with this idempotency key. Must be 1 to 200 characters.

3 status codes
200Returns a page containing an array of Card Validation objects and a `next_cursor` value for retrieving the next page; the cursor is null when there are no more results.
dataarray<CardValidation>required
The contents of the list.
next_cursorstringrequired
A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.
4XXReturned when the request is invalid or cannot be processed.
5XXReturned when the server encounters an error processing the request.

Error handling

limit must be at least 1 and no greater than 100; it defaults to 100 when omitted. status.in accepts comma-delimited values from requires_attention, pending_submission, submitted, complete, and declined, and idempotency_key must be 1 to 200 characters. Supply creation-time filters as ISO 8601 timestamps.