Get Billing Company Details By Id

Testing Env

https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch

GET

/api/bill-payments/billers/{id}

Maintainer:Not configured

Inquire billing company details for a unique id associated with a combination of companyCode, serviceProvided, category, subCategory, furtherSubCategory

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Responses

🟢200OK

application/json

Billing company details successfully retrieved.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch/api/bill-payments/billers/11202' \
--header 'X-Request-ID: 3d8f0c44-d4c7-4c7b-8a67-78e34b4d947e' \
--header 'X-ServiceAccount-ID: fba7b7f3-1a90-4d63-bef9-12f2a72a5275' \
--header 'X-Organisation-ID: d321b5af-6e4b-4e47-87d2-7f7eabc84c5f' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "id": "1",
    "companyCode": "550001",
    "billerCode": "550001",
    "companyDescription": "Airtel",
    "serviceProvided": "TELECOM",
    "serviceProvidedDescription": "Mobile",
    "category": "POSTPAID",
    "categoryDescription": "Post paid",
    "subCategory": "2GBDownload",
    "subCategoryDescription": "2GB per day",
    "furtherSubCategory": "Plan1299",
    "furtherSubCategoryDescription": "Plan 1299",
    "amountInputMethod": "CUSTOMER-ENTERED",
    "supportedCurrency": "EUR",
    "isPartialAllowed": false,
    "minimumAmountAllowed": 100,
    "isExcessAllowed": false,
    "maxAmountAllowed": 100,
    "additionalDataRequired": [
        {
            "fieldName": "BILLALPHA1",
            "fieldType": "ALPHANUMERIC",
            "isMandatory": false,
            "fieldDescription": "Consumer No"
        }
    ],
    "lastAmendedDate": "2019-08-24",
    "allowedSourceId": [
        {
            "source": "BRANCH-TELLER"
        }
    ]
}

Modified at 2025-07-10 05:30:41

Search Billing Company Details

Subscribe to a Bill