> ## 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 Card Details List — Wasl Cards API Reference

> Fetch all available denominations for a specific card vendor, including localized names, pricing, and current stock levels for each denomination.

The Get Card Details endpoint returns all denominations available for a given card vendor. For each denomination you receive the card's localized name, its price (`amount`), and the number of units currently in stock (`balance`). Use this data to display accurate pricing and availability to your customers before they place an order.

## Endpoint

```
POST /api-service/card/get-card-details-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` |

## Request Body

<ParamField body="vendor_id" type="string" required>
  The unique vendor identifier for the card whose denominations you want to retrieve. Obtain this value from the `vendor_id` field in the [Get Card List](/api-reference/cards/get-card-list) response.
</ParamField>

### Example Request

```json Request theme={null}
{
  "vendor_id": 34
}
```

## 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 card denomination objects belonging to the requested vendor.

  <Expandable title="data[]">
    <ResponseField name="card_id" type="string">
      The unique identifier for this specific card denomination. Use this value when calling the [Get Card Balance](/api-reference/cards/get-card-balance) endpoint or when placing a card order.
    </ResponseField>

    <ResponseField name="name_in_english" type="string">
      The denomination name in English (for example, `"Xbox $10"`).
    </ResponseField>

    <ResponseField name="name_in_arabic" type="string">
      The denomination name in Arabic.
    </ResponseField>

    <ResponseField name="amount" type="string">
      The price of this card denomination as a decimal string.
    </ResponseField>

    <ResponseField name="balance" type="integer">
      The number of units of this denomination currently available in stock.
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json Response theme={null}
{
  "status": true,
  "code": "11111",
  "data": [
    {
      "card_id": "59",
      "name_in_english": "Xbox $10",
      "name_in_arabic": "Xbox $10",
      "amount": "3.30",
      "balance": 5
    },
    {
      "card_id": "60",
      "name_in_english": "Xbox $15",
      "name_in_arabic": "Xbox $15",
      "amount": "4.9",
      "balance": 13
    }
  ]
}
```

<Note>
  The `balance` field reflects the stock count at the time of the request. Inventory can change between calls, so check the balance immediately before initiating a purchase using the [Get Card Balance](/api-reference/cards/get-card-balance) endpoint.
</Note>

<Tip>
  Present both `name_in_english` and `name_in_arabic` in your UI if you serve customers in multiple languages. Both fields are always returned in the response.
</Tip>


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