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

# List products

> List products available for purchase.

Load products for a service, provider, or both. Each item includes the display details, price, validation requirement, and availability needed to present a purchase option.

## Parameters

At least one of `service` or `provider` is required. Send both when you want products for a single provider within a service.

<ParamField query="service" type="string">
  Service returned by List services, such as `data`, `airtime`, `electricity`, or `tv`.
</ParamField>

<ParamField query="provider" type="string">
  Provider returned by List providers, such as `MTN`, `AIRTEL`, `DSTV`, or `GOTV`.
</ParamField>

## Request

```http theme={null}
GET /api/v2/get-products?service=data
Authorization: Bearer YOUR_API_KEY
```

## Successful response

```json theme={null}
{
  "status": true,
  "message": "Products fetched successfully.",
  "data": [
    {
      "service": "data",
      "product_name": "mtn-share-weekly-1gb",
      "provider": "MTN",
      "category": "weekly",
      "sub_category": "share",
      "description": "1GB weekly data bundle",
      "quantity": "1GB",
      "validity": "7 days",
      "fixed_price": 400,
      "amount_required": false,
      "require_validation": false,
      "available": true
    }
  ]
}
```

## Failed response

```json theme={null}
{
  "status": false,
  "message": "Error message"
}
```