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

# GET /api-service/card/get-card-list — Get Card List

> Retrieve the full catalog of available gift and prepaid card vendors, including their unique IDs and localized names in English and Arabic.

The Get Card List endpoint returns the complete catalog of card vendors available on the Wasl platform. Each vendor entry includes a unique `vendor_id` that you use to look up the specific denominations and pricing for that card type. This is typically the first call you make when building an integration or populating a product catalog.

## Endpoint

```
GET /api-service/card/get-card-list
```

| Environment | Base URL |
| - | - |
| Development | `https://development.payzah.net` |
| Production | `https://Payzah.net/production770` |

## Request Headers

| Header | Value |
| - | - |
| `Content-Type` | `application/json` |
| `Authorization` | `<your token>` |
| `Token` | `token` |

This endpoint does not require a request body.

## Response

### Response Fields

<ResponseField name="status" type="boolean">
  Indicates whether the request succeeded. Returns `true` on success.
</ResponseField>

<ResponseField name="code" type="string">
  A status code for the response. `"11111"` indicates success.
</ResponseField>

<ResponseField name="data" type="array">
  An array of vendor objects representing the available cards.

  <Expandable title="data[]">
    <ResponseField name="vendor_id" type="string">
      The unique identifier for this card vendor. Use this value as the `vendor_id` parameter when calling the [Get Card Details](/api-reference/cards/get-card-details) endpoint.
    </ResponseField>

    <ResponseField name="name" type="string">
      The card or vendor name in English.
    </ResponseField>

    <ResponseField name="name_ar" type="string">
      The card or vendor name in Arabic.
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json Response theme={null}
{
  "status": true,
  "code": "11111",
  "data": [
    {
      "vendor_id": "34",
      "name": "Xbox Card",
      "name_ar": "بوكس اكس بطاقات"
    },
    {
      "vendor_id": "36",
      "name": "Play Station Card- US",
      "name_ar": "أمريكي -ستيشن بالي بطاقات"
    }
  ]
}
```

<Tip>
  Call this endpoint once and cache the results in your system rather than fetching the list on every user request. The catalog changes infrequently, so a periodic refresh (for example, once per day) is usually sufficient. Use the `vendor_id` values from this response to fetch detailed card denominations via the [Get Card Details](/api-reference/cards/get-card-details) endpoint.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.