Home
Release Notes
Home
Release Notes
Linkedin
  1. Services
  • Baladâ„¢ Gateway Documentation đŸ“–
  • Get Started
  • Authorization
  • Responses
  • Go Live!
  • FAQs
  • APIs
    • Authentication
      • Token
    • Core
      • Exchange rate
        • Exchange Rates
      • Balance
        • Get Current Balance
      • Secrets
        • Generate Secret
        • Delete Secret
        • Get Secrets
    • Link
      • Sandbox Testing Guide
      • Error Codes
      • Transaction Lifecycle V2
      • Lookups
        • Purposes List
        • Sources List
        • Banks List
        • Relations
      • Transactions
        • Create transaction
        • Update transaction
        • Cancel transaction
        • Get transaction status V2
        • Transactions List
        • Export Transactions List
        • Validate Account
        • Request Sender Document Upload URL
      • Reconciliation
        • Reconciliation
      • Quotations
        • Create Quotation
    • Bills
      • Services
        • Categories
          GET
        • Providers
          GET
        • Services
          GET
        • Service Configurations
          GET
        • available currencies
          GET
      • Payments
        • Inquiry
        • Fees
        • Confirm Payment
        • Bill Payment List
  • Webhooks
    • Link.Transaction.StatusUpdateV2
  1. Services

Categories

GET
/bills/categories
The "Get Categories" API retrieves a list of all available categories for bill payment purposes. Users can utilize the retrieved information to display category options within their applications.
Response Params
SI NoParameterRemarks
1idCategory ID
2nameCategory name

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://gateway-sandbox.balad.tech/bills/categories' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Responses

đŸŸ¢200Success
application/json
Bodyapplication/json

Example
{
    "data": [
        {
            "id": 1,
            "name": "Internet/ADSL"
        },
        {
            "id": 2,
            "name": "Mobile Recharge"
        },
        {
            "id": 3,
            "name": "Mobile Bills"
        }
    ],
    "errors": null
}
Previous
Bills
Next
Providers
Built with