> ## 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 a Bill Information

> Fetch bill details provided by billers.



## OpenAPI

````yaml get /billers/{biller_code}/items
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:
  /billers/{biller_code}/items:
    get:
      tags:
        - Bill Payments
      summary: Get a Bill Information
      description: Fetch bill details provided by billers.
      operationId: GetaBillInformation
      parameters:
        - name: biller_code
          in: path
          description: ''
          required: true
          style: simple
          schema:
            type: string
            example: BIL119
        - 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:51:21 GMT
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '1644'
            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/"66c-AanLt7ucnI6WBydjQSyHeQ"
            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/GetaBillInformation'
                  - example:
                      status: success
                      message: Bill items fetched successfully
                      data:
                        - id: 34
                          biller_code: BIL119
                          name: DSTV Payment
                          default_commission: 0.1
                          date_added: '2020-09-17T15:56:58.057Z'
                          country: NG
                          is_airtime: false
                          biller_name: DSTV Payment
                          item_code: CB140
                          short_name: DSTV Premium
                          fee: 100
                          commission_on_fee: true
                          reg_expression: ^[0-9]+$
                          label_name: SmartCard Number
                          amount: 14600
                          is_resolvable: true
                          group_name: DSTV
                          category_name: Cable Bill Payment
                          is_data: null
                          default_commission_on_amount: null
                          commission_on_fee_or_amount: null
                          validity_period: null
                        - id: 35
                          biller_code: BIL119
                          name: DSTV
                          default_commission: 0.1
                          date_added: '2020-09-17T15:56:58.057Z'
                          country: NG
                          is_airtime: false
                          biller_name: DSTV Access
                          item_code: CB141
                          short_name: DSTV Access
                          fee: 100
                          commission_on_fee: true
                          reg_expression: ^[0-9]+$
                          label_name: SmartCard Number
                          amount: 1800
                          is_resolvable: true
                          group_name: DSTV
                          category_name: Cable Bill Payment
                          is_data: null
                          default_commission_on_amount: null
                          commission_on_fee_or_amount: null
                          validity_period: null
                        - id: 91
                          biller_code: BIL119
                          name: DSTV
                          default_commission: 0.1
                          date_added: '2020-09-17T15:56:58.057Z'
                          country: NG
                          is_airtime: false
                          biller_name: DSTV Premium
                          item_code: CB140
                          short_name: DSTV
                          fee: 100
                          commission_on_fee: true
                          reg_expression: ^[0-9]+$
                          label_name: SmartCard Number
                          amount: 14600
                          is_resolvable: true
                          group_name: Cable Bill Payment
                          category_name: Cable Bill Payment
                          is_data: null
                          default_commission_on_amount: null
                          commission_on_fee_or_amount: null
                          validity_period: null
              example:
                status: success
                message: Bill items fetched successfully
                data:
                  - id: 34
                    biller_code: BIL119
                    name: DSTV Payment
                    default_commission: 0.1
                    date_added: '2020-09-17T15:56:58.057Z'
                    country: NG
                    is_airtime: false
                    biller_name: DSTV Payment
                    item_code: CB140
                    short_name: DSTV Premium
                    fee: 100
                    commission_on_fee: true
                    reg_expression: ^[0-9]+$
                    label_name: SmartCard Number
                    amount: 14600
                    is_resolvable: true
                    group_name: DSTV
                    category_name: Cable Bill Payment
                    is_data: null
                    default_commission_on_amount: null
                    commission_on_fee_or_amount: null
                    validity_period: null
                  - id: 35
                    biller_code: BIL119
                    name: DSTV
                    default_commission: 0.1
                    date_added: '2020-09-17T15:56:58.057Z'
                    country: NG
                    is_airtime: false
                    biller_name: DSTV Access
                    item_code: CB141
                    short_name: DSTV Access
                    fee: 100
                    commission_on_fee: true
                    reg_expression: ^[0-9]+$
                    label_name: SmartCard Number
                    amount: 1800
                    is_resolvable: true
                    group_name: DSTV
                    category_name: Cable Bill Payment
                    is_data: null
                    default_commission_on_amount: null
                    commission_on_fee_or_amount: null
                    validity_period: null
                  - id: 91
                    biller_code: BIL119
                    name: DSTV
                    default_commission: 0.1
                    date_added: '2020-09-17T15:56:58.057Z'
                    country: NG
                    is_airtime: false
                    biller_name: DSTV Premium
                    item_code: CB140
                    short_name: DSTV
                    fee: 100
                    commission_on_fee: true
                    reg_expression: ^[0-9]+$
                    label_name: SmartCard Number
                    amount: 14600
                    is_resolvable: true
                    group_name: Cable Bill Payment
                    category_name: Cable Bill Payment
                    is_data: null
                    default_commission_on_amount: null
                    commission_on_fee_or_amount: null
                    validity_period: null
        '400':
          description: Bad Request
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Sun, 24 Mar 2024 08:58:19 GMT
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '62'
            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/"3e-Bnm4U9Za4fVwiRZc3wHskQ"
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/GetaBillInformation-Errorresponse1'
                  - example:
                      status: error
                      message: Invalid Biller code
                      data: null
              example:
                status: error
                message: Invalid Biller code
                data: null
      deprecated: false
components:
  schemas:
    GetaBillInformation:
      title: GetaBillInformation
      required:
        - status
        - message
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/Data72'
          description: ''
      example:
        status: success
        message: Bill items fetched successfully
        data:
          - id: 34
            biller_code: BIL119
            name: DSTV Payment
            default_commission: 0.1
            date_added: '2020-09-17T15:56:58.057Z'
            country: NG
            is_airtime: false
            biller_name: DSTV Payment
            item_code: CB140
            short_name: DSTV Premium
            fee: 100
            commission_on_fee: true
            reg_expression: ^[0-9]+$
            label_name: SmartCard Number
            amount: 14600
            is_resolvable: true
            group_name: DSTV
            category_name: Cable Bill Payment
            is_data: null
            default_commission_on_amount: null
            commission_on_fee_or_amount: null
            validity_period: null
          - id: 35
            biller_code: BIL119
            name: DSTV
            default_commission: 0.1
            date_added: '2020-09-17T15:56:58.057Z'
            country: NG
            is_airtime: false
            biller_name: DSTV Access
            item_code: CB141
            short_name: DSTV Access
            fee: 100
            commission_on_fee: true
            reg_expression: ^[0-9]+$
            label_name: SmartCard Number
            amount: 1800
            is_resolvable: true
            group_name: DSTV
            category_name: Cable Bill Payment
            is_data: null
            default_commission_on_amount: null
            commission_on_fee_or_amount: null
            validity_period: null
          - id: 91
            biller_code: BIL119
            name: DSTV
            default_commission: 0.1
            date_added: '2020-09-17T15:56:58.057Z'
            country: NG
            is_airtime: false
            biller_name: DSTV Premium
            item_code: CB140
            short_name: DSTV
            fee: 100
            commission_on_fee: true
            reg_expression: ^[0-9]+$
            label_name: SmartCard Number
            amount: 14600
            is_resolvable: true
            group_name: Cable Bill Payment
            category_name: Cable Bill Payment
            is_data: null
            default_commission_on_amount: null
            commission_on_fee_or_amount: null
            validity_period: null
    GetaBillInformation-Errorresponse1:
      title: GetaBillInformation-Errorresponse1
      required:
        - status
        - message
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: string
          nullable: true
      example:
        status: error
        message: Invalid Biller code
        data: null
    Data72:
      title: Data72
      required:
        - id
        - biller_code
        - name
        - default_commission
        - date_added
        - country
        - is_airtime
        - biller_name
        - item_code
        - short_name
        - fee
        - commission_on_fee
        - reg_expression
        - label_name
        - amount
        - is_resolvable
        - group_name
        - category_name
        - is_data
        - default_commission_on_amount
        - commission_on_fee_or_amount
        - validity_period
      type: object
      properties:
        id:
          type: integer
          format: int32
        biller_code:
          type: string
        name:
          type: string
        default_commission:
          type: number
        date_added:
          type: string
        country:
          type: string
        is_airtime:
          type: boolean
        biller_name:
          type: string
        item_code:
          type: string
        short_name:
          type: string
        fee:
          type: integer
          format: int32
        commission_on_fee:
          type: boolean
        reg_expression:
          type: string
        label_name:
          type: string
        amount:
          type: integer
          format: int32
        is_resolvable:
          type: boolean
        group_name:
          type: string
        category_name:
          type: string
        is_data:
          type: string
          nullable: true
        default_commission_on_amount:
          type: string
          nullable: true
        commission_on_fee_or_amount:
          type: string
          nullable: true
        validity_period:
          type: string
          nullable: true
      example:
        id: 34
        biller_code: BIL119
        name: DSTV Payment
        default_commission: 0.1
        date_added: '2020-09-17T15:56:58.057Z'
        country: NG
        is_airtime: false
        biller_name: DSTV Payment
        item_code: CB140
        short_name: DSTV Premium
        fee: 100
        commission_on_fee: true
        reg_expression: ^[0-9]+$
        label_name: SmartCard Number
        amount: 14600
        is_resolvable: true
        group_name: DSTV
        category_name: Cable Bill Payment
        is_data: null
        default_commission_on_amount: null
        commission_on_fee_or_amount: null
        validity_period: null
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````