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

# List Cards

> List all cards created by your partner account

Returns a paginated list of all cards. Only cards belonging to your partner account are returned.

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer sk_staging_your_api_key`
</ParamField>

<ParamField query="skip" type="integer" default="0">
  Number of records to skip for pagination.
</ParamField>

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

<RequestExample>
  ```bash cURL theme={null}
  curl "https://services-staging.getplu.com/api/v1/partner/card?skip=0&limit=20" \
    -H "Authorization: Bearer sk_staging_your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://services-staging.getplu.com/api/v1/partner/card?skip=0&limit=20',
    {
      headers: {
        'Authorization': 'Bearer sk_staging_your_api_key',
      },
    }
  );
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": "success",
    "message": "Cards retrieved",
    "data": {
      "cards": [
        {
          "serviceCardId": "acme-card-xyz789jkl012mno",
          "serviceId": "acme-user-abc123def456ghi",
          "cardName": "Jane Doe",
          "last4": "9012",
          "status": "active",
          "availableBalance": 50,
          "ledgerBalance": 50,
          "cardProgram": "custodial",
          "fundingType": "float",
          "createdAt": "2025-01-15T10:30:00.000Z"
        },
        {
          "serviceCardId": "acme-card-def456ghi789jkl",
          "serviceId": "acme-user-mno345pqr678stu",
          "cardName": "John Smith",
          "last4": "5678",
          "status": "frozen",
          "availableBalance": 25,
          "ledgerBalance": 25,
          "cardProgram": "custodial",
          "fundingType": "float",
          "createdAt": "2025-01-14T09:00:00.000Z"
        }
      ],
      "pagination": {
        "skip": 0,
        "limit": 20,
        "total": 2
      }
    }
  }
  ```
</ResponseExample>

<Info>
  The list endpoint returns summary data (last 4 digits only, no CVV/full card number). Use [Get Card](/api-reference/cards/get-card) to retrieve full card details for a specific card.
</Info>