> ## 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.

# List all Transfer Beneficiaries

> Get all beneficiaries saves for transfer



## OpenAPI

````yaml get /beneficiaries
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:
  /beneficiaries:
    get:
      tags:
        - Beneficiaries
      summary: List all Transfer Beneficiaries
      description: Get all beneficiaries saves for transfer
      operationId: ListallTransferBeneficiaries
      parameters: []
      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: '1683'
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                  example: W/"693-NQglBWQ1Wp6/LyQJ8wF2VQ"
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Thu, 23 Jan 2020 17:18:28 GMT
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SampleSuccessResponse9'
                  - example:
                      status: success
                      message: Payout beneficiaries fetched
                      meta:
                        page_info:
                          total: 9
                          current_page: 1
                          total_pages: 1
                      data:
                        - id: 3768
                          account_number: '0690000040'
                          bank_code: '044'
                          full_name: Alexis Sanchez
                          meta: null
                          created_at: '2020-01-20T16:09:24.000Z'
                          bank_name: ACCESS BANK NIGERIA
                        - id: 3690
                          account_number: '0690000039'
                          bank_code: '044'
                          full_name: Dotun Ajib
                          meta: null
                          created_at: '2020-01-19T22:36:06.000Z'
                          bank_name: ACCESS BANK NIGERIA
                        - id: 3644
                          account_number: '0690000034'
                          bank_code: '044'
                          full_name: Ade Bond
                          meta: null
                          created_at: '2020-01-16T18:01:28.000Z'
                          bank_name: ACCESS BANK NIGERIA
                        - id: 3608
                          account_number: '0690000044'
                          bank_code: '044'
                          full_name: Mercedes Daniel
                          meta: null
                          created_at: '2020-01-15T11:58:02.000Z'
                          bank_name: ACCESS BANK NIGERIA
                        - id: 3565
                          account_number: '0690000038'
                          bank_code: '044'
                          full_name: John Sunday
                          meta: null
                          created_at: '2020-01-14T05:53:34.000Z'
                          bank_name: ACCESS BANK NIGERIA
                        - id: 3104
                          account_number: '2540782773934'
                          bank_code: '000'
                          full_name: Kwame Adew
                          meta: null
                          created_at: '2019-12-05T23:49:31.000Z'
                          bank_name: FA-BANK
                        - id: 3093
                          account_number: '0690000041'
                          bank_code: '044'
                          full_name: Alexis Rogers
                          meta: null
                          created_at: '2019-12-05T21:29:57.000Z'
                          bank_name: ACCESS BANK NIGERIA
                        - id: 2923
                          account_number: '0690000032'
                          bank_code: '044'
                          full_name: Pastor Bright
                          meta: null
                          created_at: '2019-11-28T08:15:29.000Z'
                          bank_name: ACCESS BANK NIGERIA
                        - id: 2857
                          account_number: '0690000031'
                          bank_code: '044'
                          full_name: Forrest Green
                          meta: null
                          created_at: '2019-11-20T10:33:20.000Z'
                          bank_name: ACCESS BANK NIGERIA
              example:
                status: success
                message: Payout beneficiaries fetched
                meta:
                  page_info:
                    total: 9
                    current_page: 1
                    total_pages: 1
                data:
                  - id: 3768
                    account_number: '0690000040'
                    bank_code: '044'
                    full_name: Alexis Sanchez
                    meta: null
                    created_at: '2020-01-20T16:09:24.000Z'
                    bank_name: ACCESS BANK NIGERIA
                  - id: 3690
                    account_number: '0690000039'
                    bank_code: '044'
                    full_name: Dotun Ajib
                    meta: null
                    created_at: '2020-01-19T22:36:06.000Z'
                    bank_name: ACCESS BANK NIGERIA
                  - id: 3644
                    account_number: '0690000034'
                    bank_code: '044'
                    full_name: Ade Bond
                    meta: null
                    created_at: '2020-01-16T18:01:28.000Z'
                    bank_name: ACCESS BANK NIGERIA
                  - id: 3608
                    account_number: '0690000044'
                    bank_code: '044'
                    full_name: Mercedes Daniel
                    meta: null
                    created_at: '2020-01-15T11:58:02.000Z'
                    bank_name: ACCESS BANK NIGERIA
                  - id: 3565
                    account_number: '0690000038'
                    bank_code: '044'
                    full_name: John Sunday
                    meta: null
                    created_at: '2020-01-14T05:53:34.000Z'
                    bank_name: ACCESS BANK NIGERIA
                  - id: 3104
                    account_number: '2540782773934'
                    bank_code: '000'
                    full_name: Kwame Adew
                    meta: null
                    created_at: '2019-12-05T23:49:31.000Z'
                    bank_name: FA-BANK
                  - id: 3093
                    account_number: '0690000041'
                    bank_code: '044'
                    full_name: Alexis Rogers
                    meta: null
                    created_at: '2019-12-05T21:29:57.000Z'
                    bank_name: ACCESS BANK NIGERIA
                  - id: 2923
                    account_number: '0690000032'
                    bank_code: '044'
                    full_name: Pastor Bright
                    meta: null
                    created_at: '2019-11-28T08:15:29.000Z'
                    bank_name: ACCESS BANK NIGERIA
                  - id: 2857
                    account_number: '0690000031'
                    bank_code: '044'
                    full_name: Forrest Green
                    meta: null
                    created_at: '2019-11-20T10:33:20.000Z'
                    bank_name: ACCESS BANK NIGERIA
      deprecated: false
components:
  schemas:
    SampleSuccessResponse9:
      title: SampleSuccessResponse9
      required:
        - status
        - message
        - meta
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        meta:
          $ref: '#/components/schemas/Meta22'
        data:
          type: array
          items:
            $ref: '#/components/schemas/Data41'
          description: ''
      example:
        status: success
        message: Payout beneficiaries fetched
        meta:
          page_info:
            total: 9
            current_page: 1
            total_pages: 1
        data:
          - id: 3768
            account_number: '0690000040'
            bank_code: '044'
            full_name: Alexis Sanchez
            meta: null
            created_at: '2020-01-20T16:09:24.000Z'
            bank_name: ACCESS BANK NIGERIA
          - id: 3690
            account_number: '0690000039'
            bank_code: '044'
            full_name: Dotun Ajib
            meta: null
            created_at: '2020-01-19T22:36:06.000Z'
            bank_name: ACCESS BANK NIGERIA
          - id: 3644
            account_number: '0690000034'
            bank_code: '044'
            full_name: Ade Bond
            meta: null
            created_at: '2020-01-16T18:01:28.000Z'
            bank_name: ACCESS BANK NIGERIA
          - id: 3608
            account_number: '0690000044'
            bank_code: '044'
            full_name: Mercedes Daniel
            meta: null
            created_at: '2020-01-15T11:58:02.000Z'
            bank_name: ACCESS BANK NIGERIA
          - id: 3565
            account_number: '0690000038'
            bank_code: '044'
            full_name: John Sunday
            meta: null
            created_at: '2020-01-14T05:53:34.000Z'
            bank_name: ACCESS BANK NIGERIA
          - id: 3104
            account_number: '2540782773934'
            bank_code: '000'
            full_name: Kwame Adew
            meta: null
            created_at: '2019-12-05T23:49:31.000Z'
            bank_name: FA-BANK
          - id: 3093
            account_number: '0690000041'
            bank_code: '044'
            full_name: Alexis Rogers
            meta: null
            created_at: '2019-12-05T21:29:57.000Z'
            bank_name: ACCESS BANK NIGERIA
          - id: 2923
            account_number: '0690000032'
            bank_code: '044'
            full_name: Pastor Bright
            meta: null
            created_at: '2019-11-28T08:15:29.000Z'
            bank_name: ACCESS BANK NIGERIA
          - id: 2857
            account_number: '0690000031'
            bank_code: '044'
            full_name: Forrest Green
            meta: null
            created_at: '2019-11-20T10:33:20.000Z'
            bank_name: ACCESS BANK NIGERIA
    Meta22:
      title: Meta22
      required:
        - page_info
      type: object
      properties:
        page_info:
          $ref: '#/components/schemas/PageInfo'
      example:
        page_info:
          total: 158
          current_page: 1
          total_pages: 16
    Data41:
      title: Data41
      required:
        - id
        - account_number
        - bank_code
        - full_name
        - meta
        - created_at
        - bank_name
      type: object
      properties:
        id:
          type: integer
          format: int32
        account_number:
          type: string
        bank_code:
          type: string
        full_name:
          type: string
        meta:
          type: string
          nullable: true
        created_at:
          type: string
        bank_name:
          type: string
      example:
        id: 3768
        account_number: '0690000040'
        bank_code: '044'
        full_name: Alexis Sanchez
        meta: null
        created_at: '2020-01-20T16:09:24.000Z'
        bank_name: ACCESS BANK NIGERIA
    PageInfo:
      title: PageInfo
      required:
        - total
        - current_page
        - total_pages
      type: object
      properties:
        total:
          type: integer
          format: int32
        current_page:
          type: integer
          format: int32
        total_pages:
          type: integer
          format: int32
      example:
        total: 158
        current_page: 1
        total_pages: 16
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````