> ## Documentation Index
> Fetch the complete documentation index at: https://flutterwaveinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Biller Details

> Query supported billers by country.



## OpenAPI

````yaml get /bills/{category}/billers
openapi: 3.0.0
info:
  title: Flutterwave v3
  description: >-
    The Flutterwave for Business(F4B) APIs collection for all v3 endpoints with
    pre-formatted requests and response examples.
  contact: {}
  version: '1.0'
servers:
  - url: https://api.flutterwave.com/v3
    variables: {}
security:
  - bearer: []
tags:
  - name: Charges
    description: >-
      The charge APIs includes several payment collection methods to help you
      collect payments.
  - name: Tokenized Charges
    description: Tokenize your customers' cards with Flutterwave for faster payments
  - name: Preauthorization
    description: Manage preauth attemps on card transactions
  - name: Transactions
    description: Manage transactions, query statuses, logs and fees
  - name: Transfers
    description: Transfers to local and international customers
  - name: Beneficiaries
    description: Manage transfer beneficiaries
  - name: Virtual Cards
    description: Manage Flutterwave virtual cards
  - name: Virtual Account Numbers
    description: Manage virtual accounts
  - name: Collection Subaccounts
    description: Manage Collection Subaccounts
  - name: Payout Subaccounts
    description: Manage Payout Subaccounts
  - name: Subscriptions
    description: Manage user subscriptions
  - name: Payment Plans
    description: Manage Payment Plans
  - name: Bill Payments
    description: Manage Bill Payments
  - name: Banks
    description: Fetch Bank Information
  - name: Misc
    description: >-
      Verify user information like bank verification numbers, card bins, account
      information
  - name: Settlements
    description: Manage your settlements
  - name: Otps
    description: Create and manage one time passwords (OTPs) for your applications
  - name: Chargebacks
    description: Manage Chargebacks
paths:
  /bills/{category}/billers:
    get:
      tags:
        - Bill Payments
      summary: Get Biller Details
      description: Query supported billers by country.
      operationId: GetBillerDetails
      parameters:
        - name: country
          in: query
          description: ''
          required: true
          style: form
          explode: true
          schema:
            type: string
            example: NG
        - name: category
          in: path
          description: ''
          required: true
          style: simple
          schema:
            type: string
            example: CABLEBILLS
        - name: Content-Type
          in: header
          description: ''
          required: true
          style: simple
          schema:
            enum:
              - application/json
            type: string
            example: application/json
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Sun, 24 Mar 2024 08:46:30 GMT
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '1012'
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
            Server:
              content:
                text/plain:
                  schema:
                    type: string
                  example: nginx/1.24.0
            Access-Control-Allow-Origin:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '*'
            Access-Control-Allow-Headers:
              content:
                text/plain:
                  schema:
                    type: string
                  example: >-
                    Origin, X-Requested-With, Content-Type, Accept,
                    Authorization, v3-xapp-id, flw-auth-token, mra-auth-token,
                    alt_mode_auth, mid, altmodeauth, cc-admin-token, x-flw-lang
            Access-Control-Allow-Methods:
              content:
                text/plain:
                  schema:
                    type: string
                  example: PUT, POST, GET, DELETE, OPTIONS
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                  example: W/"3f4-Gi+EDyCaeETR1eTuLYXHOQ"
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                  example: max-age=31536000; includeSubDomains; preload; always;
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/GetBillerDetails'
                  - example:
                      status: success
                      message: Billers fetched successfully
                      data:
                        - id: 66
                          name: DSTV
                          logo: null
                          description: DSTV
                          short_name: DSTV
                          biller_code: BIL119
                          country_code: NG
                        - id: 67
                          name: GOTV
                          logo: null
                          description: GOTV
                          short_name: GOTV
                          biller_code: BIL120
                          country_code: NG
                        - id: 68
                          name: DAARSAT Communications
                          logo: null
                          description: DAARSAT Communications
                          short_name: DAARSAT Communications
                          biller_code: BIL123
                          country_code: NG
                        - id: 69
                          name: DSTV BOX OFFICE
                          logo: null
                          description: DSTV BOX OFFICE
                          short_name: DSTV BOX OFFICE
                          biller_code: BIL125
                          country_code: NG
                        - id: 70
                          name: MyTV
                          logo: null
                          description: MyTV
                          short_name: MyTV
                          biller_code: BIL128
                          country_code: NG
                        - id: 71
                          name: HiTV
                          logo: null
                          description: HiTV
                          short_name: HiTV
                          biller_code: BIL129
                          country_code: NG
                        - id: 91
                          name: STARTIMES
                          logo: null
                          description: STARTIMES
                          short_name: STARTIMES
                          biller_code: BIL123
                          country_code: NG
              example:
                status: success
                message: Billers fetched successfully
                data:
                  - id: 66
                    name: DSTV
                    logo: null
                    description: DSTV
                    short_name: DSTV
                    biller_code: BIL119
                    country_code: NG
                  - id: 67
                    name: GOTV
                    logo: null
                    description: GOTV
                    short_name: GOTV
                    biller_code: BIL120
                    country_code: NG
                  - id: 68
                    name: DAARSAT Communications
                    logo: null
                    description: DAARSAT Communications
                    short_name: DAARSAT Communications
                    biller_code: BIL123
                    country_code: NG
                  - id: 69
                    name: DSTV BOX OFFICE
                    logo: null
                    description: DSTV BOX OFFICE
                    short_name: DSTV BOX OFFICE
                    biller_code: BIL125
                    country_code: NG
                  - id: 70
                    name: MyTV
                    logo: null
                    description: MyTV
                    short_name: MyTV
                    biller_code: BIL128
                    country_code: NG
                  - id: 71
                    name: HiTV
                    logo: null
                    description: HiTV
                    short_name: HiTV
                    biller_code: BIL129
                    country_code: NG
                  - id: 91
                    name: STARTIMES
                    logo: null
                    description: STARTIMES
                    short_name: STARTIMES
                    biller_code: BIL123
                    country_code: NG
        '400':
          description: Bad Request
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Sun, 24 Mar 2024 08:47:55 GMT
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '64'
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
            Server:
              content:
                text/plain:
                  schema:
                    type: string
                  example: nginx/1.24.0
            Access-Control-Allow-Origin:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '*'
            Access-Control-Allow-Headers:
              content:
                text/plain:
                  schema:
                    type: string
                  example: >-
                    Origin, X-Requested-With, Content-Type, Accept,
                    Authorization, v3-xapp-id, flw-auth-token, mra-auth-token,
                    alt_mode_auth, mid, altmodeauth, cc-admin-token, x-flw-lang
            Access-Control-Allow-Methods:
              content:
                text/plain:
                  schema:
                    type: string
                  example: PUT, POST, GET, DELETE, OPTIONS
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                  example: W/"40-92wUCd2K7Rzqsy78GPAkrg"
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/GetBillerDetails-Errorresponse1'
                  - example:
                      status: error
                      message: Invalid category code
                      data: null
              example:
                status: error
                message: Invalid category code
                data: null
      deprecated: false
components:
  schemas:
    GetBillerDetails:
      title: GetBillerDetails
      required:
        - status
        - message
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/Data71'
          description: ''
      example:
        status: success
        message: Billers fetched successfully
        data:
          - id: 66
            name: DSTV
            logo: null
            description: DSTV
            short_name: DSTV
            biller_code: BIL119
            country_code: NG
          - id: 67
            name: GOTV
            logo: null
            description: GOTV
            short_name: GOTV
            biller_code: BIL120
            country_code: NG
          - id: 68
            name: DAARSAT Communications
            logo: null
            description: DAARSAT Communications
            short_name: DAARSAT Communications
            biller_code: BIL123
            country_code: NG
          - id: 69
            name: DSTV BOX OFFICE
            logo: null
            description: DSTV BOX OFFICE
            short_name: DSTV BOX OFFICE
            biller_code: BIL125
            country_code: NG
          - id: 70
            name: MyTV
            logo: null
            description: MyTV
            short_name: MyTV
            biller_code: BIL128
            country_code: NG
          - id: 71
            name: HiTV
            logo: null
            description: HiTV
            short_name: HiTV
            biller_code: BIL129
            country_code: NG
          - id: 91
            name: STARTIMES
            logo: null
            description: STARTIMES
            short_name: STARTIMES
            biller_code: BIL123
            country_code: NG
    GetBillerDetails-Errorresponse1:
      title: GetBillerDetails-Errorresponse1
      required:
        - status
        - message
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: string
          nullable: true
      example:
        status: error
        message: Invalid category code
        data: null
    Data71:
      title: Data71
      required:
        - id
        - name
        - logo
        - description
        - short_name
        - biller_code
        - country_code
      type: object
      properties:
        id:
          type: integer
          format: int32
        name:
          type: string
        logo:
          type: string
          nullable: true
        description:
          type: string
        short_name:
          type: string
        biller_code:
          type: string
        country_code:
          type: string
      example:
        id: 66
        name: DSTV
        logo: null
        description: DSTV
        short_name: DSTV
        biller_code: BIL119
        country_code: NG
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````