List cards
The merchant's cards, newest first, with cursor pagination. A card is created when its application is issued; status changes are sent with the card.status_changed webhook.
Card number, CVV, expiry date and balance are not returned.
merchantApiKeymerchantTimestampmerchantNoncemerchantSignatureX-API-KEY<token>Merchant API key (starts with upk_, also accepts api-key); signing headers are also required
X-Timestamp<token>Unix timestamp in seconds, within 300 seconds of server time
X-Nonce<token>Unique per request; cannot be reused with the same credential during the timestamp validity window
X-Signature<token>Hex HMAC-SHA256 signature (either letter case) of the method, full path, timestamp, nonce and body digest
status?stringpending_active: issued, not yet activated by the issueractive: usablefreezing/unfreezing: freeze or unfreeze in progressfrozen: frozenterminating: termination in progressterminated: terminated (cards terminated at the issuer or bank also becometerminatedafter a sync)
To freeze, unfreeze or terminate, see POST /cards/{cardId}/freeze, /unfreeze and /terminate.
"pending_active""active""freezing""unfreezing""frozen""terminating""terminated"customer_id?stringOnly cards of this customer (starts with cus_)
cardholder_id?stringOnly cards of this cardholder (starts with chd_)
limit?integerPage size, 1 to 100, default 20
1 <= value <= 100cursor?stringnext_cursor from the previous page
Cards; next_cursor is null when there are no more
application/json- response
data*array<>next_cursor*string|nullcurl -X GET 'https://sandbox.getupp.net/api/v1/cards'{ "data": [ { "id": "string", "card_product_id": "string", "application_id": "string", "order_no": "string", "cardholder_id": "string", "customer_id": "string", "currency": "string", "status": "pending_active", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "next_cursor": "string"}