List Provider Types

LIVE
Endpoint

Send a GET request to retrieve all provider categories. No request body or query parameters are required.

Production URL
https://pairgate.com/api/v1/providers
Method GET
Test Endpoint
https://pairgate.com/api/v1/test/providers
Authentication

This request requires a valid Bearer token.

Header Value Description
Authorization
Bearer {token}
Your unique API authorization token
Code Examples

Choose your preferred language below. Replace YOUR_API_KEY with your actual API key.

PHP (Laravel)
// Get Provider Types
$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_API_KEY',
    'Cache-Control' => 'no-cache',
])->get('https://pairgate.com/api/v1/providers');

$result = $response->json();

dd($result);
cURL
curl -X GET "https://pairgate.com/api/v1/providers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Cache-Control: no-cache"
Node.js
const axios = require('axios');

const getProviders = async () => {
    try {
        const response = await axios.get(
            'https://pairgate.com/api/v1/providers',
            {
                headers: {
                    'Authorization': 'Bearer YOUR_API_KEY',
                    'Cache-Control': 'no-cache'
                }
            }
        );
        
        console.log(response.data);
    } catch (error) {
        console.error(error.response?.data || error.message);
    }
};

getProviders();
Python
import requests

url = "https://pairgate.com/api/v1/providers"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Cache-Control": "no-cache"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    data = response.json()
    print(data)
except requests.exceptions.RequestException as e:
    print(f"Error: {e}")
Java
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://pairgate.com/api/v1/providers"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Cache-Control", "no-cache")
    .GET()
    .build();

try {
    HttpResponse response = client.send(request, 
        HttpResponse.BodyHandlers.ofString());
    
    System.out.println(response.body());
} catch (Exception e) {
    System.err.println("Error: " + e.getMessage());
}
Response Format

A successful request returns a 200 status with an array of available provider types.

Success Response (200)
{
  "code": 200,
  "status": "success",
  "data": [
    "data",
    "airtime",
    "tv",
    "electricity",
    "education",
    "bet"
  ]
}
Response Fields
Field Type Description
data array List of available provider types
Available Provider Types

Here's what each provider type represents on the Pairgate platform.

data

Data bundle purchases

airtime

Airtime top-ups

tv

Cable TV subscriptions

electricity

Electricity bill payments

education

Exam checker pins

bet

Betting wallet funding

Error Responses

The following errors may occur when calling this endpoint.

Status Code Description
401 Missing API key No Bearer token provided
401 Invalid API key Token does not match any active key
403 Suspended API key or account has been suspended
429 Rate limited Too many requests