> ## 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 a Bulk Transfer > Create a bulk transfer ## OpenAPI ````yaml post /bulk-transfers 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-transfers: post: tags: - Transfers summary: Create a Bulk Transfer description: Create a bulk transfer operationId: CreateaBulkTransfer parameters: [] requestBody: description: '' content: application/json: schema: allOf: - $ref: '#/components/schemas/CreateaBulkTransferRequest' - example: title: Test_ZAR_Bulk_Transfers_1 bulk_data: - bank_code: FNB account_number: '0031625807099' amount: 1900 currency: ZAR narration: Test transfer to Lisa reference: bulk_Transfers_0019_PMCK meta: - first_name: Lisa last_name: Wayne email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 3200 currency: ZAR narration: Test transfer to Daemon reference: bulk_Transfers_0020_PMCK meta: - first_name: Daemon last_name: Philips email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 6950 currency: ZAR narration: Test transfer to John reference: bulk_Transfers_0021_PMCK meta: - first_name: John last_name: Kolapo email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 1500 currency: ZAR narration: Test transfer to Kara reference: bulk_Transfers_0022_PMCK meta: - first_name: Kara last_name: Johnson email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town example: title: Test_ZAR_Bulk_Transfers_1 bulk_data: - bank_code: FNB account_number: '0031625807099' amount: 1900 currency: ZAR narration: Test transfer to Lisa reference: bulk_Transfers_0019_PMCK meta: - first_name: Lisa last_name: Wayne email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 3200 currency: ZAR narration: Test transfer to Daemon reference: bulk_Transfers_0020_PMCK meta: - first_name: Daemon last_name: Philips email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 6950 currency: ZAR narration: Test transfer to John reference: bulk_Transfers_0021_PMCK meta: - first_name: John last_name: Kolapo email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 1500 currency: ZAR narration: Test transfer to Kara reference: bulk_Transfers_0022_PMCK meta: - first_name: Kara last_name: Johnson email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town 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: '129' ETag: content: text/plain: schema: type: string example: W/"81-kxmwd/DJbMKwIItuy46SBQ" Date: content: text/plain: schema: type: string example: Mon, 20 Jan 2020 16:36:29 GMT Connection: content: text/plain: schema: type: string example: keep-alive content: application/json; charset=utf-8: schema: allOf: - $ref: '#/components/schemas/SampleSuccessResponse4' - example: status: success message: Bulk transfer queued data: id: 2013 created_at: '2020-01-20T16:36:29.000Z' approver: N/A example: status: success message: Bulk transfer queued data: id: 2013 created_at: '2020-01-20T16:36:29.000Z' approver: N/A '400': description: Bad Request headers: Date: content: text/plain: schema: type: string example: Thu, 28 Mar 2024 08:47:31 GMT Content-Length: content: text/plain: schema: type: string example: '77' 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/"4d-tThKznfUf9c2Ubuhs6mepA" content: application/json; charset=utf-8: schema: allOf: - $ref: '#/components/schemas/SampleErrorResponse1' - example: status: error message: bulk_data[1].bank_code is required data: null example: status: error message: bulk_data[1].bank_code is required data: null deprecated: false components: schemas: CreateaBulkTransferRequest: title: CreateaBulkTransferRequest required: - title - bulk_data type: object properties: title: type: string bulk_data: type: array items: $ref: '#/components/schemas/BulkDatum1' description: '' example: title: Test_ZAR_Bulk_Transfers_1 bulk_data: - bank_code: FNB account_number: '0031625807099' amount: 1900 currency: ZAR narration: Test transfer to Lisa reference: bulk_Transfers_0019_PMCK meta: - first_name: Lisa last_name: Wayne email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 3200 currency: ZAR narration: Test transfer to Daemon reference: bulk_Transfers_0020_PMCK meta: - first_name: Daemon last_name: Philips email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 6950 currency: ZAR narration: Test transfer to John reference: bulk_Transfers_0021_PMCK meta: - first_name: John last_name: Kolapo email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town - bank_code: FNB account_number: '0031625807099' amount: 1500 currency: ZAR narration: Test transfer to Kara reference: bulk_Transfers_0022_PMCK meta: - first_name: Kara last_name: Johnson email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town SampleSuccessResponse4: title: SampleSuccessResponse4 required: - status - message - data type: object properties: status: type: string message: type: string data: $ref: '#/components/schemas/Data34' example: status: success message: Bulk transfer queued data: id: 2013 created_at: '2020-01-20T16:36:29.000Z' approver: N/A SampleErrorResponse1: title: SampleErrorResponse1 required: - status - message - data type: object properties: status: type: string message: type: string data: type: string nullable: true example: status: error message: >- retry_interval is required , retry_amount_variable is required , retry_attempt_variable is required data: null BulkDatum1: title: BulkDatum1 required: - bank_code - account_number - amount - currency - narration - reference - meta type: object properties: bank_code: type: string account_number: type: string amount: type: integer format: int32 currency: type: string narration: type: string reference: type: string meta: type: array items: $ref: '#/components/schemas/Meta24' description: '' example: bank_code: FNB account_number: '0031625807099' amount: 1900 currency: ZAR narration: Test transfer to Lisa reference: bulk_Transfers_0019_PMCK meta: - first_name: Lisa last_name: Wayne email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town Data34: title: Data34 required: - id - created_at - approver type: object properties: id: type: integer format: int32 created_at: type: string approver: type: string example: id: 2013 created_at: '2020-01-20T16:36:29.000Z' approver: N/A Meta24: title: Meta24 required: - first_name - last_name - email - mobile_number - recipient_address type: object properties: first_name: type: string last_name: type: string email: type: string mobile_number: type: string recipient_address: type: string example: first_name: Lisa last_name: Wayne email: test@test.com mobile_number: '+23457558595' recipient_address: 234 Kings road, Cape Town securitySchemes: bearer: type: http scheme: bearer ````