> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usezentra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Cards

> GET /api/v1/cards - Query tenant-scoped card records

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

## Endpoint

```text theme={null}
GET /api/v1/cards
```

## Query Parameters

<ParamField query="customer_id" type="string">
  Filter cards for one downstream customer. `customerId` is accepted as an alias for compatibility.
</ParamField>

<ParamField query="limit" type="number">
  Maximum number of records to return.
</ParamField>

<ParamField query="offset" type="number">
  Number of records to skip before returning results.
</ParamField>

## Example Request

```bash theme={null}
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

<CardGroup cols={2}>
  <Card title="Create Card" icon="plus" href="/api-reference/cards/create">
    Issue a new virtual or physical card
  </Card>

  <Card title="Fund Card" icon="wallet" href="/api-reference/cards/fund">
    Add balance to an existing card
  </Card>
</CardGroup>