> ## 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 Vending Categories

> Retrieve all root Value Added Services (VAS) and vending categories available on the gateway.

Retrieve the full list of top-level VAS service categories supported by the Remita SystemSpecs gateway (Electricity, Airtime, Internet Data, Cable TV, Education, and Transportation).

### Response Schema

The response returns a `data.items` array containing each category's `id`, `name`, `code`, and `description`.

```json theme={null}
{
  "message": "successful",
  "status": "00",
  "data": {
    "totalPage": 1,
    "totalContent": 6,
    "items": [
      {
        "id": 1,
        "name": "electricity",
        "description": "electricity",
        "code": "electricity"
      },
      {
        "id": 2,
        "name": "Airtime",
        "description": "Airtime",
        "code": "airtime"
      },
      {
        "id": 3,
        "name": "Internet Data Subscription",
        "description": "Internet Data Subscription",
        "code": "internet_data_subscription"
      },
      {
        "id": 4,
        "name": "Cable TV",
        "description": "Cable TV",
        "code": "cable_tv"
      },
      {
        "id": 5,
        "name": "Educations",
        "description": "Educations",
        "code": "educations"
      },
      {
        "id": 6,
        "name": "Transportation",
        "description": "Transportation",
        "code": "transportation"
      }
    ]
  }
}
```


## OpenAPI

````yaml remita_openapi.json GET /vending/categories
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/categories:
    get:
      summary: Get Vending Categories
      description: Retrieve all root VAS and vending categories available on the gateway.
      operationId: getVendingCategories
      responses:
        '200':
          description: List of vending categories
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: '00'
                  message:
                    type: string
                    example: Success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 1
                        name:
                          type: string
                          example: Electricity
                        code:
                          type: string
                          example: electricity
                        description:
                          type: string
                          example: Power DisCos
              example:
                status: '00'
                message: Success
                data:
                  - id: 1
                    name: Electricity
                    code: electricity
                    description: Power DisCos
                  - id: 2
                    name: Airtime & Data
                    code: airtime
                    description: Mobile recharge
                  - id: 3
                    name: Cable TV
                    code: cable_tv
                    description: Pay TV
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.