> ## 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. # Create Bulk Bills Payment > Initiate bulk bills payment ## OpenAPI ````yaml post /bulk-bills 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: /bulk-bills: post: tags: - Bill Payments summary: Create Bulk Bills Payment description: Initiate bulk bills payment operationId: CreateBulkBillsPayment parameters: [] requestBody: description: '' content: application/json: schema: allOf: - $ref: '#/components/schemas/CreateBulkBillsPaymentRequest' - example: bulk_reference: bulkRef0012 callback_url: https://www.google.com bulk_data: - country: NG customer: '+2348029494025' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef05 - country: NG customer: '+2347063932728' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef06 - country: NG customer: '+2347013431382' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef07 - country: NG customer: '+2348134088426' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef08 example: bulk_reference: bulkRef0012 callback_url: https://www.google.com bulk_data: - country: NG customer: '+2348029494025' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef05 - country: NG customer: '+2347063932728' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef06 - country: NG customer: '+2347013431382' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef07 - country: NG customer: '+2348134088426' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef08 required: true responses: '200': description: OK headers: X-Powered-By: content: text/plain: schema: type: string example: Express 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 Access-Control-Allow-Methods: content: text/plain: schema: type: string example: PUT, POST, GET, DELETE, OPTIONS Content-Length: content: text/plain: schema: type: string example: '143' ETag: content: text/plain: schema: type: string example: W/"8f-JVj+WK6ApE33or05MSdeBg" Date: content: text/plain: schema: type: string example: Tue, 10 Mar 2020 16:22:10 GMT Connection: content: text/plain: schema: type: string example: keep-alive content: application/json; charset=utf-8: schema: allOf: - $ref: '#/components/schemas/CreateBulkBillsPayment-success' - example: status: success message: Bulk bill Payment was queued for processing data: batch_reference: CF-BATCH-FLY-API-20200310042210201008 example: status: success message: Bulk bill Payment was queued for processing data: batch_reference: CF-BATCH-FLY-API-20200310042210201008 '400': description: Bad Request headers: Date: content: text/plain: schema: type: string example: Thu, 28 Mar 2024 11:17:24 GMT Content-Length: content: text/plain: schema: type: string example: '106' 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/"6a-9t41bjaK6SsOzItXf5sO/A" content: application/json; charset=utf-8: schema: allOf: - $ref: '#/components/schemas/CreateBulkBillsPayment-error1' - example: status: error message: >- Please specify the following parameters in body: bulk_reference data: null example: status: error message: >- Please specify the following parameters in body: bulk_reference data: null deprecated: false components: schemas: CreateBulkBillsPaymentRequest: title: CreateBulkBillsPaymentRequest required: - bulk_reference - callback_url - bulk_data type: object properties: bulk_reference: type: string callback_url: type: string bulk_data: type: array items: $ref: '#/components/schemas/BulkDatum2' description: '' example: bulk_reference: bulkRef0012 callback_url: https://www.google.com bulk_data: - country: NG customer: '+2348029494025' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef05 - country: NG customer: '+2347063932728' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef06 - country: NG customer: '+2347013431382' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef07 - country: NG customer: '+2348134088426' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef08 CreateBulkBillsPayment-success: title: CreateBulkBillsPayment-success required: - status - message - data type: object properties: status: type: string message: type: string data: $ref: '#/components/schemas/Data77' example: status: success message: Bulk bill Payment was queued for processing data: batch_reference: CF-BATCH-FLY-API-20200310042210201008 CreateBulkBillsPayment-error1: title: CreateBulkBillsPayment-error1 required: - status - message - data type: object properties: status: type: string message: type: string data: type: string nullable: true example: status: error message: 'Please specify the following parameters in body: bulk_reference' data: null BulkDatum2: title: BulkDatum2 required: - country - customer - amount - recurrence - type - reference type: object properties: country: type: string customer: type: string amount: type: integer format: int32 recurrence: type: string type: type: string reference: type: string example: country: NG customer: '+2348029494025' amount: 100 recurrence: WEEKLY type: AIRTIME reference: billRef05 Data77: title: Data77 required: - batch_reference type: object properties: batch_reference: type: string example: batch_reference: CF-BATCH-FLY-API-20200310042210201008 securitySchemes: bearer: type: http scheme: bearer ````