Skip to main content
GET
/
api
/
v1
/
cards
List Cards
curl --request GET \
  --url https://api.usezentra.com/api/v1/cards \
  --header 'Authorization: Bearer <token>'

​
List Cards

Retrieve the cards issued under your tenant. Results are tenant-scoped by default.

​
Endpoint

GET /api/v1/cards

​
Query Parameters

​
customer_id
string
Filter cards for one downstream customer. customerId is accepted as an alias for compatibility.
​
limit
number
Maximum number of records to return.
​
offset
number
Number of records to skip before returning results.

​
Example Request

curl "https://api.usezentra.com/api/v1/cards?customer_id=cust_123&limit=20&offset=0" \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

​
Response Notes

  • Results are tenant-scoped.
  • The reviewed public gateway currently exposes card listing, not a dedicated GET /api/v1/cards/{card_id} record endpoint.
  • Use the returned card_id with funding, security, and alert-management endpoints.

​
Next Steps

Create Card

Issue a new virtual or physical card

Fund Card

Add balance to an existing card