Terraswitch
  • Terraswitch - Get Started
  • Test & Live Environments
  • Onboarding as a Business
  • GUIDES
    • 🎾Authentication
    • 🧀Webhooks
    • 🫓Status & Responses
    • 🏉API Rate Limits
    • 🚀Transactions & Destinations
    • 🍊Testing Credentials
    • 🚐Crafting Metadata
  • API ENDPOINTS
    • Account
      • Get Account Details
      • Get Banks
      • Get Beneficiaries
      • Add Bank
      • Change Settlement Bank
    • Wallet
      • Get Wallet Details
      • Get Wallet Transactions
    • Collections
      • Checkout
        • Initialize Transaction
      • Transfer
        • Generate Account
      • Charge
        • Create Charge
        • Authorize Charge
        • Charge Authorization
      • Bank
        • Pay with Opay
    • Payout
      • Bank Transfer
      • Withdraw Money
    • Products
      • List Products
      • Search Products
      • Filter Products
      • Fetch Product
      • Create Product
      • Update Product
    • Subaccounts
      • List Subaccounts
      • Search Subaccounts
      • Filter Subaccounts
      • Fetch Subaccount
      • Create Subaccount
      • Update Subaccount
    • Payment Links
      • List Payment Links
      • List Payment Link Transactions
      • Search Payment Links
      • Filter Payment Links
      • Fetch Payment Link
      • Create Payment Link
      • Update Payment Link
      • Attach Payment Resource
      • Remove Subaccount
      • Enable Payment Link
      • Disable Payment Link
    • Invoices
      • List Invoices
      • Search Invoices
      • Filter Invoices
      • Fetch Invoice
      • Create Invoice
      • Update Invoice
      • Remove Invoice Item
    • Transactions
      • List Transactions
      • Search Transactions
      • Filter Transactions
      • Verify Transaction
    • Refunds
      • List Refunds
      • Fetch Refund
      • Create Refund
    • Bills Payment
      • List Mobile Networks
      • List Bill Categories
      • List Bill Sub-Categories
      • List Mobile Data Plans
      • Validate Biller
      • Validate Bill Status
      • Validate Top-Up Status
      • Buy Airtime
      • Buy Data
      • Pay Bill
    • Resources
      • List Banks
      • List Countries
      • Resolve Bank Account
Powered by GitBook
On this page
  1. API ENDPOINTS
  2. Bills Payment

List Bill Sub-Categories

Get a list of bill subcategories from a bill category Terraswitch supports

POST {{BASE_URL}}/v1/corporate/bill-sub-categories

Body Parameters

Property
Data Type
Description
Example
Required

categoryId

string or number

The bill category id

4

Yes

import Axios from 'axios';

// set the api url
const API_URL = `${BASE_URL}/v1/corporate/bill-sub-categories`;

// make request using axios
Axios({
    method: "GET",
    url: `${API_URL}`,
    headers: {
        lg: 'en',
        ch: 'web'
        Authorization: `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
    }
}).then((resp) => {
    console.log(resp)
}).catch((err) => {
    console.log(err)
})
{
    "error": false,
    "errors": [],
    "data": [
        {
            "label": "cable",
            "category": {
                "categoryId": 4,
                "name": "Cable TV Subscription",
                "subCategory": "GOTv (MultiChoice) Subscription Payment",
                "mainCategory": ""
            },
            "validation": {
                "customer": true,
                "amount": true,
                "hasBillerDetails": true,
                "select": false
            },
            "billerId": "1465",
            "billerItem": {
                "name": "GOtv Max -#4150",
                "itemId": 1465,
                "amount": "4150.00"
            },
            "countryCode": "NG",
            "currency": "NGN",
            "itemId": 1465
        },
        {
            "label": "cable",
            "category": {
                "categoryId": 4,
                "name": "Cable TV Subscription",
                "subCategory": "GOTv (MultiChoice) Subscription Payment",
                "mainCategory": ""
            },
            "validation": {
                "customer": true,
                "amount": true,
                "hasBillerDetails": true,
                "select": false
            },
            "billerId": "1466",
            "billerItem": {
                "name": "GOtv Jolli Bouquet -#2800",
                "itemId": 1466,
                "amount": "2800.00"
            },
            "countryCode": "NG",
            "currency": "NGN",
            "itemId": 1466
        }
    ],
    "message": "successful",
    "status": 200
}
PreviousList Bill CategoriesNextList Mobile Data Plans

Last updated 5 months ago