> ## 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 User Cards

> List all cards belonging to a specific user

Returns a paginated list of cards for a specific user. Only cards belonging to the specified user under your partner account are returned.

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

<ParamField path="serviceId" type="string" required>
  The user's service ID.
</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/users/acme-user-abc123def456ghi/cards?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/users/acme-user-abc123def456ghi/cards?skip=0&limit=20',
    {
      headers: {
        'Authorization': 'Bearer sk_staging_your_api_key',
      },
    }
  );
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": "success",
    "message": "success",
    "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-abc123def456ghi",
          "cardName": "Jane Doe (Travel)",
          "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
      }
    }
  }
  ```

  ```json 404 theme={null}
  {
    "status": "error",
    "message": "USER_NOT_FOUND",
    "data": {
      "error": "User not found"
    }
  }
  ```
</ResponseExample>

<Info>
  This endpoint returns the same card summary data as [List Cards](/api-reference/cards/list-cards), but filtered to a single user. Use [Get Card](/api-reference/cards/get-card) to retrieve full card details including card number and CVV.
</Info>