Get Cards
Header Parameters
Query Parameters
The associated consumer identifier (Required).
The issuing provider/bank of the card (Optional).
Filter to retrieve cards by primary status: set to 'true' to retrieve only primary cards, 'false' for only dependent cards, or omit to retrieve all cards (primary and dependent).
Number of items per page
Zero-based page number
Optional filter to search for cards by their last four digits. When provided, must be a valid four-digit numeric string (e.g., "0123").
Comma-separated list of optional fields to include in the response. Supported value: allowed_actions. When specified, each card in the response will include an allowed_actions object. When omitted, the standard card response is returned without the allowed_actions field.
Response
Successful retrieval of the list of cards.
Response Attributes
List of card resources.
Show child attributes
Show child attributes
Invalid request.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Unauthorized. Authentication failed.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Forbidden. User does not have permission to access card resources for the specified consumer.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Consumer not found.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Internal server error. An unexpected error occurred while processing the request.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Unexpected error
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.