> ## 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 All Providers

> Retrieve all active biller providers, brand logos, and metadata supported across all service categories.

Fetch the complete catalog of billers and service providers (over 51 providers including GoTV, DStv, Startimes, WAEC, JAMB, Cowry, and international telcos).

### Usage & Response

Use the returned provider `code` and `logoUrl` to render branded bill payment screens in your merchant app.

```json theme={null}
{
  "message": "successful",
  "status": "00",
  "data": {
    "totalPage": 6,
    "totalContent": 51,
    "items": [
      {
        "code": "gotv",
        "name": "GoTV",
        "description": "GoTV",
        "logoUrl": "https://res.cloudinary.com/remita/image/upload/v1673952126/Biller%20API%20Images/GoTV_gy5pxy.png"
      },
      {
        "code": "waec",
        "name": "West African Examinations Council",
        "description": "West African Examinations Council",
        "logoUrl": "https://res.cloudinary.com/remita/image/upload/v1735894565/Biller%20API%20Images/WAEC_cnbt7a.png"
      }
    ]
  }
}
```


## OpenAPI

````yaml remita_openapi.json GET /vending/providers
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/providers:
    get:
      summary: Get All Providers
      description: Retrieve all 51 active biller providers with logos and brand details.
      operationId: getVendingProviders
      responses:
        '200':
          description: List of active providers
          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: 101
                        name:
                          type: string
                          example: Abuja Electricity (AEDC)
                        code:
                          type: string
                          example: AEDC
                        logoUrl:
                          type: string
                          example: https://cdn.remita.net/logos/aedc.png
              example:
                status: '00'
                message: Success
                data:
                  - id: 101
                    name: Abuja Electricity (AEDC)
                    code: AEDC
                    logoUrl: https://cdn.remita.net/logos/aedc.png
                  - id: 102
                    name: Ikeja Electric (IKEDC)
                    code: IKEDC
                    logoUrl: https://cdn.remita.net/logos/ikedc.png
                  - id: 201
                    name: MTN Nigeria
                    code: MTN
                    logoUrl: https://cdn.remita.net/logos/mtn.png
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.