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

# Get Products Catalog

> Discover biller packages, data plans, tariffs, and product codes filtered by category code and country.

Fetch the detailed offerings, tariff structures, and specific product codes for any category.

### Query Parameters

| Parameter | Type | Required | Default | Description |
| :- | :- | :- | :- | :- |
| `categoryCode` | `string` | **Yes** | `electricity` | Category code (e.g. `electricity`, `airtime`, `internet_data_subscription`, `cable_tv`). |
| `countryCode` | `string` | No | `NGA` | ISO-3 country code (Default: `NGA`). |
| `page` | `integer` | No | `0` | Zero-indexed page number for pagination. |
| `pageSize` | `integer` | No | `20` | Number of items per page. |

### Sample Response

```json theme={null}
{
  "message": "successful",
  "status": "00",
  "data": {
    "totalPage": 2,
    "totalContent": 34,
    "items": [
      {
        "id": 300,
        "code": "300",
        "name": "Abuja Electricity Distribution Company",
        "description": "AEDC Prepaid Meter Token",
        "amount": 0,
        "provider": "AEDC",
        "currency": "NGN"
      }
    ]
  }
}
```


## OpenAPI

````yaml remita_openapi.json GET /vending/products
openapi: 3.0.3
info:
  title: Remita (SystemSpecs) VAS & Collection API
  description: >-
    Interactive API specification for Remita / SystemSpecs Connect Gateway VAS
    Vending, Utilities, and RRR Biller Collections.
  version: 1.0.0
servers:
  - url: https://api-demo.systemspecsng.com/services/connect-gateway/api/v1
    description: Sandbox / Demo Environment (UAT)
  - url: https://api-gateway.remita.net/api/v1
    description: Production Live Environment
security:
  - SecretKey: []
paths:
  /vending/products:
    get:
      summary: Get Products Catalog
      description: >-
        Retrieve biller packages, tariffs, and offerings by category and
        country.
      operationId: getProducts
      parameters:
        - name: categoryCode
          in: query
          required: true
          schema:
            type: string
            default: electricity
          example: electricity
        - name: countryCode
          in: query
          required: false
          schema:
            type: string
            default: NGA
          example: NGA
        - name: page
          in: query
          required: false
          schema:
            type: string
            default: '0'
          example: '0'
        - name: pageSize
          in: query
          required: false
          schema:
            type: string
            default: '20'
          example: '20'
      responses:
        '200':
          description: Product catalog items
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: '00'
                  message:
                    type: string
                    example: Success
                  data:
                    type: object
                    properties:
                      page:
                        type: integer
                        example: 0
                      pageSize:
                        type: integer
                        example: 20
                      total:
                        type: integer
                        example: 2
                      products:
                        type: array
                        items:
                          type: object
                          properties:
                            productCode:
                              type: string
                              example: '300'
                            name:
                              type: string
                              example: AEDC Prepaid
                            categoryCode:
                              type: string
                              example: electricity
                            price:
                              type: number
                              example: 0
                            currency:
                              type: string
                              example: NGN
              example:
                status: '00'
                message: Success
                data:
                  page: 0
                  pageSize: 20
                  total: 2
                  products:
                    - productCode: '300'
                      name: AEDC Prepaid
                      categoryCode: electricity
                      price: 0
                      currency: NGN
                    - productCode: '301'
                      name: AEDC Postpaid
                      categoryCode: electricity
                      price: 0
                      currency: NGN
components:
  securitySchemes:
    SecretKey:
      type: apiKey
      in: header
      name: secretKey
      description: SystemSpecs Demo / Live Secret Key
      x-default: sk_test_l/pQgOLgziOTzb+7pcUXVH2iX1MlpROsePDkNi/g/QmMs2c8P0DPr1vUP7xESiGG

````

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