Search Billing Company Details

Testing Env

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

GET

/api/bill-payments/billers

Maintainer:Not configured

Retrieve billing company details associated with the customer

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query 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?sourceId=web-app' \
--header 'X-Request-ID: 3d8f0c44-d4c7-4c7b-8a67-78e34b4d947e' \
--header 'X-ServiceAccount-ID: 0e92f7e6-8b2a-11ec-b909-0242ac120002' \
--header 'X-Organisation-ID: f1a44684-3c8b-45bb-97f4-4cfa261b29ae' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "items": [
        {
            "id": "1",
            "companyCode": "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"
                }
            ]
        }
    ],
    "links": {
        "self": {
            "href": "string",
            "templated": true
        },
        "first": {
            "href": "string",
            "templated": true
        },
        "next": {
            "href": "string",
            "templated": true
        },
        "prev": {
            "href": "string",
            "templated": true
        }
    }
}

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

Search Billing Company Details

Get Billing Company Details By Id