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

# Fetch All EUR subaccounts

> This endpoint is used to display all EUR subaccounts that have been created under your Payaza Account



## OpenAPI

````yaml /openapi.json post /payaza-account/api/v1/subaccounts/merchant/enquiry/business
openapi: 3.0.1
info:
  title: Payaza Documentation
  version: 2.0.0
  description: >-
    API reference for processing payments using Card, Bank Transfer, USSD, and
    QR Code methods.
servers:
  - url: https://api.payaza.africa/live
security:
  - ApiKeyAuth: []
  - TenantID: []
  - ProductID: []
tags:
  - name: Transfers
    description: >-
      Transfers are transactions made from your Payaza account to beneficiaries.
      Merchants can instantly transfer funds from their available balance. For
      every transfer, you need to specify the amount and the beneficiary’s
      details. You become eligible to make transfers after you have been
      verified. (you sign up, finish account activation and KYC verification).
  - name: Payaza Account
    description: >-
      This is our internal account that can be used to make payouts to other
      bank accounts, in single or in bulk. The Payaza account can also be used
      to receive settlements. It can also be used to track the transfer status
      of your transactions and check your balance instantly
  - name: Sub Accounts
    description: >-
      This enables you to establish Sub Payaza accounts for your customers. Each
      sub-account comes with an assigned static virtual account, facilitating
      direct funding for individual accounts. Furthermore, the Main Payaza
      account can directly initiate funding for each sub-account. These
      sub-accounts serve the purpose of managing unique account positions or
      balances and facilitating disbursements from these positions to specified
      beneficiaries.
  - name: EUR Accounts
    description: >-
      This endpoints enable you to create EUR subaccounts which can be used to
      make transfers as required .
  - name: Apple Pay and Google Pay
    description: >-
      Apple Pay and Google Pay give your customers a fast, familiar, and secure
      way to complete payments. Our APIs provide a gateway to provide these
      services to your users for a smooth payment experience.
  - name: Virtual Accounts
    description: >-
      Virtual Accounts are bank accounts that are created for a specific purpose
      and last for specified durations. Virtual accounts are issued by Payaza’s
      partner banks. Our virtual account APIs can be used to create virtual
      accounts and perform other tasks relevant to virtual accounts. Virtual
      accounts are created to foster easy payment collections for your business
      and platform. 

      Static/Reserved Account: This virtual account is created by the merchant
      and remains valid indefinitely. It can be used multiple times and does not
      expire. 

      Dynamic Account: This virtual account is generated for a specific
      transaction or purpose. Please note that dynamic virtual account remains
      valid for a temporary period of time or until a payment of the specified
      amount is received. Upon expiry, a merchant can generate another one for a
      different purpose.
  - name: Card Collection
    description: >-
      The Card Collection APIs can be used to make card transactions, refund
      transactions that have been performed, check the status of a transaction
      and so much more.
  - name: Card Tokenisation
    description: >-
      The Card Tokenisation APIs are used to create card tokens, charge cards
      using tokens, retrieve all tokens created by a merchant account and
      deleting any card token as desired.
  - name: Refunds And Chargebacks
    description: >-
      The Refunds and Chargeback APIs are used to initiate refunds, view your
      refund and chargeback history and so much more.
  - name: Branches
    description: >-
      The Refunds and Chargeback APIs are used to initiate refunds, view your
      refund and chargeback history and so much more.
  - name: Auth-Capture-Void
    description: >-
      The Auth-Capture-Void APIs provide a two-phase payment process where
      transactions are first authorized, then captured or voided. This allows
      merchants to hold funds and complete the transaction in the future.
  - name: Momo and ZAR Collections
    description: APIs for MoMo, ZAR and XOF collections.
  - name: Check Transaction Status(Merchant Reference)
    description: >-
      This endpoint is used to check the transaction status of a transaction
      using the Merchant Reference..
paths:
  /payaza-account/api/v1/subaccounts/merchant/enquiry/business:
    post:
      tags:
        - EUR Accounts
      summary: Fetch All EUR subaccounts
      description: >-
        This endpoint is used to display all EUR subaccounts that have been
        created under your Payaza Account
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - $ref: '#/components/schemas/fetchAllEurSubAccountsRequest'
            examples:
              fetchAllEurSubaccounts:
                summary: Fetch All EUR subaccounts
                value:
                  pageSize: 10
                  pageNumber: 1
                  currency: EUR
                  searchPhrase: ''
      responses:
        '200':
          description: Account Enquiry Response
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/fetchAllEurSubAccountsResponse'
              examples:
                fetchAllSEurSubAccounts:
                  summary: Fetch All EUR subaccounts
                  value:
                    message: Account enquiry response
                    status: true
                    data:
                      - id: 3796
                        accountName: Zachery Borer
                        payazaAccountReference: '80810030592'
                        status: ACTIVE
                        accountBalance: 100000000
                        businessId: 2046
                        currency: EUR
                        country: NGA
                        organizationName: PAYAZA
                        productCode: PAYOUT-SUB-EUR
                        productNumber: '8899'
                        postNoCredit: false
                        postNoDebit: false
                        hasVirtualAccounts: true
                        virtualAccounts:
                          - accountNumber: GB00213143149028220528
                            accountName: Zachery Borer
                            bankCode: ARPYGB21XXX
                            bankId: 793
                        holdTransactionAtLowBalance: false
                        createdDate: '2025-03-11T00:01:21.113663'
                      - id: 3665
                        accountName: Nikolaus and Sons
                        payazaAccountReference: '80810030461'
                        status: ACTIVE
                        accountBalance: 100000000
                        businessId: 2046
                        currency: EUR
                        country: NGA
                        organizationName: PAYAZA
                        productCode: PAYOUT-SUB-EUR
                        productNumber: '8899'
                        postNoCredit: false
                        postNoDebit: false
                        hasVirtualAccounts: true
                        virtualAccounts:
                          - accountNumber: GB31305690917679873490
                            accountName: Nikolaus and Sons
                            bankCode: ARPYGB21XXX
                            bankId: 761
                        holdTransactionAtLowBalance: false
                        createdDate: '2025-03-09T08:30:05.188118'
                    responseCode: null
                    pageDetail:
                      sorted: true
                      pageNumber: 1
                      pageSize: 10
                      paged: true
                      totalPages: 2
                      totalElements: 10
                      last: false
                      size: 10
                      number: 0
                      numberOfElements: 10
                      offset: 0
        '400':
          description: Invalid request
      security:
        - ApiKeyAuth: []
          TenantID: []
components:
  schemas:
    fetchAllEurSubAccountsRequest:
      title: Fetch All Euro SubAccounts Request
      type: object
      properties:
        pageSize:
          type: integer
          description: The number of items to return per page.
          example: 10
        pageNumber:
          type: integer
          description: The current page number to retrieve.
          example: 1
        currency:
          type: string
          description: The currency filter for the accounts.
          example: EUR
        searchPhrase:
          type: string
          description: Optional search term to filter results.
          example: ''
      required:
        - pageSize
        - pageNumber
        - currency
    fetchAllEurSubAccountsResponse:
      title: Fetch All Euro SubAccounts Response
      type: object
      properties:
        message:
          type: string
          description: Response message.
          example: Account enquiry response
        status:
          type: boolean
          description: Request status.
          example: true
        data:
          type: array
          description: List of accounts found.
          items:
            type: object
            properties:
              id:
                type: integer
                description: Unique account ID.
                example: 3796
              accountName:
                type: string
                description: Name of the account holder.
                example: Zachery Borer
              payazaAccountReference:
                type: string
                description: Unique Payaza reference for the account.
                example: '80810030592'
              status:
                type: string
                description: Status of the account.
                example: ACTIVE
              accountBalance:
                type: number
                format: double
                description: Current account balance.
                example: 100000000
              businessId:
                type: integer
                description: ID of the business owning the account.
                example: 2046
              currency:
                type: string
                description: Account currency.
                example: EUR
              country:
                type: string
                description: Account country code.
                example: NGA
              organizationName:
                type: string
                description: Organization name.
                example: PAYAZA
              productCode:
                type: string
                description: Product code.
                example: PAYOUT-SUB-EUR
              productNumber:
                type: string
                description: Product number.
                example: '8899'
              postNoCredit:
                type: boolean
                description: Is credit posting restricted?
                example: false
              postNoDebit:
                type: boolean
                description: Is debit posting restricted?
                example: false
              hasVirtualAccounts:
                type: boolean
                description: Does this account have virtual accounts attached?
                example: true
              virtualAccounts:
                type: array
                description: List of attached virtual accounts.
                items:
                  type: object
                  properties:
                    accountNumber:
                      type: string
                      description: Virtual account number.
                      example: GB00213143149028220528
                    accountName:
                      type: string
                      description: Name on the virtual account.
                      example: Zachery Borer
                    bankCode:
                      type: string
                      description: Bank code for the virtual account.
                      example: ARPYGB21XXX
                    bankId:
                      type: integer
                      description: Bank ID.
                      example: 793
              holdTransactionAtLowBalance:
                type: boolean
                description: Whether transactions are held if balance is low.
                example: false
              createdDate:
                type: string
                format: date-time
                description: Date the account was created.
                example: '2025-03-11T00:01:21.113663'
        responseCode:
          type: string
          nullable: true
          description: Response code (if applicable).
          example: null
        pageDetail:
          type: object
          description: Pagination details.
          properties:
            sorted:
              type: boolean
              example: true
            pageNumber:
              type: integer
              example: 1
            pageSize:
              type: integer
              example: 10
            paged:
              type: boolean
              example: true
            totalPages:
              type: integer
              example: 2
            totalElements:
              type: integer
              example: 10
            last:
              type: boolean
              example: false
            size:
              type: integer
              example: 10
            number:
              type: integer
              example: 0
            numberOfElements:
              type: integer
              example: 10
            offset:
              type: integer
              example: 0
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Payaza {{Public API Key in Base 64}}
    TenantID:
      type: apiKey
      in: header
      name: X-TenantID
      description: live or test
    ProductID:
      type: apiKey
      in: header
      name: X-ProductID
      description: 'default value is ‟app” '

````