# List business transactions

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /businesses/accounts/transactions:
    get:
      summary: List business transactions
      deprecated: false
      description: >-

        Returns paginated list of SUCCESSFUL transactions for a business
        account.


        This endpoint provides comprehensive transaction history with advanced
        filtering and cursor-based pagination.


        Query Parameters:

        - **start_date/end_date**: ISO-8601 date range filters (e.g.,
        2025-05-01). If not provided, defaults to today's date.

        - **type**: Comma-separated transaction types (fund, payout)

        - **limit**: Results per page (1-200, default 10)

        - **cursor**: Pagination cursor for next page


        Features:

        - **Date Range Filtering**: Inclusive date filtering with automatic
        default to today

        - **Transaction Type Filtering**: Filter by fund transactions and payout
        transfers

        - **Cursor-Based Pagination**: Efficient pagination for large result
        sets

        - **Sorted Results**: Transactions sorted by created_at desc (most
        recent first)


        Response Format:

        - **data**: Array of transaction details (same format as single
        transaction endpoint)

        - **pagination**: Cursor-based pagination metadata with next/prev
        cursors


        Error Scenarios:

        - 400: Invalid date format, invalid type values, invalid cursor

        - 404: Account not found
                    
      operationId: getTransactionsList
      tags:
        - Vrtx APIs/Transactions/Business Accounts
        - Transactions/Business Accounts
      parameters:
        - name: start_date
          in: query
          description: Start date filter (ISO-8601, e.g., 2025-05-01)
          required: false
          schema:
            type: string
            format: date
        - name: end_date
          in: query
          description: End date filter (ISO-8601)
          required: false
          schema:
            type: string
            format: date
        - name: type
          in: query
          description: Comma-separated transaction types (e.g., fund,payout)
          required: false
          example: m2p_payout
          schema:
            type: string
        - name: limit
          in: query
          description: ''
          required: false
          schema:
            type: string
            default: '10'
        - name: cursor
          in: query
          description: Pagination cursor for next page
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        transaction_reference:
                          type: string
                          description: Bank reference number or transaction reference
                        transaction_type:
                          type: string
                          description: Transaction type
                        source_account_number:
                          type: string
                          description: Source account number
                        destination_account_number:
                          type: string
                          description: Destination account reference
                        destination_external_reference:
                          type: string
                          description: >-
                            Destination account's external reference. Empty when
                            the destination is not a customer wallet, has no
                            external reference set, or was posted before the
                            field was recorded
                        sender_id:
                          type: string
                          description: Deprecated — use source_account_number
                        receiver_id:
                          type: string
                          description: Deprecated — use destination_account_number
                        amount:
                          type: string
                        balance:
                          type: string
                          description: >-
                            Account balance after transaction with
                            currency-specific decimal places (0-3 decimals)
                        direction:
                          type: string
                          description: >-
                            Transaction direction relative to business account
                            (debit/credit)
                        currency:
                          type: string
                          default: SAR
                          description: Transaction currency
                        created_at:
                          type: string
                          description: Transaction creation timestamp (ISO 8601)
                        description:
                          type: string
                        beneficiary_details:
                          type: object
                          properties:
                            iban:
                              type: string
                              description: Counterparty IBAN
                            beneficiary_name:
                              type: string
                              description: Counterparty name as reported by the bank
                          required:
                            - iban
                            - beneficiary_name
                          description: >-
                            External-rail counterparty (ANB-funded transactions
                            only)
                        internal_id:
                          type: string
                          description: >-
                            Internal Formance ledger reference (e.g.
                            pt_0001shd133223u1h)
                      required:
                        - transaction_reference
                        - transaction_type
                        - source_account_number
                        - destination_account_number
                        - destination_external_reference
                        - sender_id
                        - receiver_id
                        - amount
                        - balance
                        - direction
                        - currency
                        - created_at
                        - description
                        - beneficiary_details
                        - internal_id
                    description: Array of transaction details
                  pagination:
                    type: object
                    properties:
                      page_size:
                        type: integer
                      has_next:
                        type: boolean
                        description: Whether there are more items to fetch
                      has_prev:
                        type: boolean
                        description: Whether there are previous items
                      next_cursor:
                        type: string
                        description: Cursor for next page
                    required:
                      - page_size
                      - has_next
                      - has_prev
                      - next_cursor
                    description: Pagination metadata
                required:
                  - data
                  - pagination
              example:
                data:
                  - transaction_reference: fund_10013335e1f1b
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '100.00'
                    balance: '3166481.94'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T13:10:11.508Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: ''
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38951'
                  - transaction_reference: fund_100bfb8feceac
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '200.00'
                    balance: '3166381.94'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T13:10:11.436Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: ''
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38950'
                  - transaction_reference: fund_10049a927c9ef
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '62500.00'
                    balance: '3166181.94'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T12:55:10.873Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: '0108057386290014'
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38949'
                  - transaction_reference: fund_100894dd6ba79
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '678.90'
                    balance: '3103681.94'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T12:00:08.049Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: I011660104991051
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38948'
                  - transaction_reference: fund_1009653928973
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '444.44'
                    balance: '3103003.04'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T12:00:07.998Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: I011660104991051
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38947'
                  - transaction_reference: fund_1008696fb32d5
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '2574.50'
                    balance: '3102558.60'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T11:35:09.296Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: I011660104991051
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38946'
                  - transaction_reference: fund_10045c4bcc3f3
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '74.00'
                    balance: '3099984.10'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T11:35:09.245Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: I011660104991051
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38945'
                  - transaction_reference: fund_1001038a2e355
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '100.00'
                    balance: '3099910.10'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T11:35:09.200Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: I011660104991051
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38944'
                  - transaction_reference: fund_1005b4405720c
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '123.45'
                    balance: '3099810.10'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T11:35:09.155Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: I011660104991051
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38943'
                  - transaction_reference: fund_10084835fbb65
                    transaction_type: fund
                    source_account_number: world
                    destination_account_number: REF_bus_5989620
                    destination_external_reference: ''
                    sender_id: world
                    receiver_id: REF_bus_5989620
                    amount: '1574.00'
                    balance: '3099686.65'
                    direction: credit
                    currency: SAR
                    created_at: '2026-05-12T11:35:09.126Z'
                    description: Topup via ANB credit
                    beneficiary_details:
                      iban: I011660104991051
                      beneficiary_name: HAMH HR ANUAES ERCOR CE O
                    internal_id: '38942'
                pagination:
                  page_size: 10
                  has_next: true
                  has_prev: false
                  next_cursor: >-
                    eyJwYWdlU2l6ZSI6MTAsImJvdHRvbSI6Mzg5NTEsImNvbHVtbiI6ImlkIiwicGFnaW5hdGlvbklEIjozODk0MSwib3JkZXIiOjEsImZpbHRlcnMiOnsicGl0IjpudWxsLCJvb3QiOm51bGwsInFiIjp7IiRhbmQiOlt7IiRvciI6W3siJG1hdGNoIjp7InNvdXJjZSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJkZXN0aW5hdGlvbiI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtzb3VyY2VfcmVmZXJlbmNlX2lkXSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtkZXN0aW5hdGlvbl9yZWZlcmVuY2VfaWRdIjoiMTEwMDE4MjcxMDE3In19LHsiJG1hdGNoIjp7Im1ldGFkYXRhW2Rlc3RpbmF0aW9uX2FjY291bnRfbnVtYmVyXSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtzb3VyY2VfYWNjb3VudF9udW1iZXJdIjoiMTEwMDE4MjcxMDE3In19LHsiJG1hdGNoIjp7InNvdXJjZSI6IjExMDAxODI3MTAxNzpwZW5kaW5nIn19LHsiJG1hdGNoIjp7ImRlc3RpbmF0aW9uIjoiMTEwMDE4MjcxMDE3OnBlbmRpbmcifX0seyIkbWF0Y2giOnsic291cmNlIjoiMTEwMDE4MjcxMDE3OmhvbGQifX0seyIkbWF0Y2giOnsiZGVzdGluYXRpb24iOiIxMTAwMTgyNzEwMTc6aG9sZCJ9fV19LHsiJG1hdGNoIjp7Im1ldGFkYXRhW3R5cGVdIjoiUFJFRlVORCJ9fV19LCJleHBhbmQiOlsidm9sdW1lcyJdLCJvcHRzIjpudWxsfSwicmV2ZXJzZSI6ZmFsc2V9
          headers: {}
          x-apidog-name: Fund
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - INVALID_INPUT
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: INVALID_INPUT
                error_message: Input validation failed
                details:
                  - field_name: email
                    description: Invalid email format
                    code: VALIDATION_ERROR
                status_code: 400
          headers: {}
          x-apidog-name: ''
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - UNAUTHORIZED
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: UNAUTHORIZED
                error_message: Unauthorized access
                details: []
                status_code: 401
          headers: {}
          x-apidog-name: ''
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - FORBIDDEN
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: FORBIDDEN
                error_message: Access forbidden
                details: []
                status_code: 403
          headers: {}
          x-apidog-name: ''
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - NOT_FOUND
                      - ACCOUNT_NOT_FOUND
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              examples:
                example1:
                  summary: example1
                  value:
                    error_code: NOT_FOUND
                    error_message: Resource not found
                    details: []
                    status_code: 404
                example2:
                  summary: example2
                  value:
                    error_code: ACCOUNT_NOT_FOUND
                    error_message: Account not found
                    details: []
                    status_code: 404
          headers: {}
          x-apidog-name: ''
        '405':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - INVALID_INPUT
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: INVALID_INPUT
                error_message: Input validation failed
                details: []
                status_code: 405
          headers: {}
          x-apidog-name: ''
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - CONFLICT
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: CONFLICT
                error_message: Resource conflict
                details: []
                status_code: 409
          headers: {}
          x-apidog-name: ''
        '410':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - NOT_FOUND
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: NOT_FOUND
                error_message: Resource not found
                details: []
                status_code: 410
          headers: {}
          x-apidog-name: ''
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - INVALID_INPUT
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: INVALID_INPUT
                error_message: Input validation failed
                details:
                  - field_name: amount
                    description: Amount must be greater than zero
                    code: VALIDATION_ERROR
                status_code: 422
          headers: {}
          x-apidog-name: ''
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - RATE_LIMITED
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: RATE_LIMITED
                error_message: Too many requests
                details: []
                status_code: 429
          headers: {}
          x-apidog-name: ''
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - INTERNAL_ERROR
                      - EXTERNAL_SERVICE_ERROR
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              examples:
                example1:
                  summary: example1
                  value:
                    error_code: INTERNAL_ERROR
                    error_message: An internal server error occurred
                    details: []
                    status_code: 500
                example2:
                  summary: example2
                  value:
                    error_code: EXTERNAL_SERVICE_ERROR
                    error_message: An external service error occurred
                    details: []
                    status_code: 500
          headers: {}
          x-apidog-name: ''
        '501':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - INTERNAL_ERROR
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: INTERNAL_ERROR
                error_message: An internal server error occurred
                details: []
                status_code: 501
          headers: {}
          x-apidog-name: ''
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - SERVICE_UNAVAILABLE
                      - EXTERNAL_SERVICE_ERROR
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              examples:
                example1:
                  summary: example1
                  value:
                    error_code: SERVICE_UNAVAILABLE
                    error_message: >-
                      Service is currently not available. Please try again
                      later.
                    details: []
                    status_code: 503
                example2:
                  summary: example2
                  value:
                    error_code: EXTERNAL_SERVICE_ERROR
                    error_message: An external service error occurred
                    details: []
                    status_code: 503
          headers: {}
          x-apidog-name: ''
        '504':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - EXTERNAL_SERVICE_ERROR
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: EXTERNAL_SERVICE_ERROR
                error_message: An external service error occurred
                details: []
                status_code: 504
          headers: {}
          x-apidog-name: ''
        '505':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error_code:
                    type: string
                    enum:
                      - UNSUPPORTED_VERSION
                  error_message:
                    type: string
                    description: Human-readable error message explaining what went wrong
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        field_name:
                          type: string
                          description: Name of the field that caused the error
                        description:
                          type: string
                          description: Detailed description of the field error
                        code:
                          type: string
                          description: Optional error code specific to this field
                      required:
                        - field_name
                        - description
                      x-apidog-orders:
                        - field_name
                        - description
                        - code
                    description: >-
                      Additional error details and field-specific validation
                      errors
                  status_code:
                    type: number
                    description: HTTP status code corresponding to this error
                required:
                  - error_code
                  - error_message
                  - details
                  - status_code
                x-apidog-orders:
                  - error_code
                  - error_message
                  - details
                  - status_code
              example:
                error_code: UNSUPPORTED_VERSION
                error_message: An internal server error occurred
                details: []
                status_code: 500
          headers: {}
          x-apidog-name: ''
        x-200:Payout:
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        transaction_reference:
                          type: string
                        transaction_type:
                          type: string
                        source_account_number:
                          type: string
                        destination_account_number:
                          type: string
                        destination_external_reference:
                          type: string
                        sender_id:
                          type: string
                        receiver_id:
                          type: string
                        amount:
                          type: string
                        balance:
                          type: string
                        direction:
                          type: string
                        currency:
                          type: string
                        created_at:
                          type: string
                        description:
                          type: string
                        internal_id:
                          type: string
                      required:
                        - transaction_reference
                        - transaction_type
                        - source_account_number
                        - destination_account_number
                        - destination_external_reference
                        - sender_id
                        - receiver_id
                        - amount
                        - balance
                        - direction
                        - currency
                        - created_at
                        - description
                        - internal_id
                  pagination:
                    type: object
                    properties:
                      page_size:
                        type: integer
                      has_next:
                        type: boolean
                      has_prev:
                        type: boolean
                      next_cursor:
                        type: string
                    required:
                      - page_size
                      - has_next
                      - has_prev
                      - next_cursor
                required:
                  - data
                  - pagination
              example:
                data:
                  - transaction_reference: payout_100b73ff57ff6
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: '210019527040'
                    destination_external_reference: E0010
                    sender_id: '110018271017'
                    receiver_id: '210019527040'
                    amount: '10.00'
                    balance: '3044665.96'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-24T06:45:55.791Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40932'
                  - transaction_reference: payout_100fd40655507
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: '211006951919'
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: '211006951919'
                    amount: '100.00'
                    balance: '3044675.96'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-19T10:04:23.737Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40904'
                  - transaction_reference: payout_100e201bfab15
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: '211004101839'
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: '211004101839'
                    amount: '100.00'
                    balance: '3044775.96'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-18T06:40:31.450Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40896'
                  - transaction_reference: cycle-20260805175215-20222-M2P_PAYOUT-25-32647
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: 211004931750:pending
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: 211004931750:pending
                    amount: '1.25'
                    balance: '3044875.96'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-05T16:52:31.294Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40611'
                  - transaction_reference: payout_100ca469feff8
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: '211009954883'
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: '211009954883'
                    amount: '4994.25'
                    balance: '3044877.21'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-05T14:09:08.547Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40589'
                  - transaction_reference: cycle-20260803093819-15423-M2P_PAYOUT-49-8401
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: 211006247296:pending
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: 211006247296:pending
                    amount: '1.49'
                    balance: '3049877.21'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-03T08:38:30.638Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40291'
                  - transaction_reference: cycle-20260803093234-27989-M2P_PAYOUT-97-314
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: 211006247296:pending
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: 211006247296:pending
                    amount: '1.97'
                    balance: '3049878.70'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-03T08:32:45.381Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40253'
                  - transaction_reference: cycle-20260802180156-3086-M2P_PAYOUT-57-5822
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: 211006247296:pending
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: 211006247296:pending
                    amount: '1.57'
                    balance: '3049880.67'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-02T17:02:05.204Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40204'
                  - transaction_reference: cycle-20260802180103-9203-M2P_PAYOUT-95-20333
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: 211006247296:pending
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: 211006247296:pending
                    amount: '1.95'
                    balance: '3049882.24'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-02T17:01:18.681Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40175'
                  - transaction_reference: payout_1009869699dea
                    transaction_type: m2p_payout
                    source_account_number: '110018271017'
                    destination_account_number: '211006829726'
                    destination_external_reference: ''
                    sender_id: '110018271017'
                    receiver_id: '211006829726'
                    amount: '900.00'
                    balance: '3049884.19'
                    direction: debit
                    currency: SAR
                    created_at: '2026-08-02T13:41:54.404Z'
                    description: Card transaction - SAU (M2P_PAYOUT)
                    internal_id: '40149'
                pagination:
                  page_size: 10
                  has_next: true
                  has_prev: false
                  next_cursor: >-
                    eyJwYWdlU2l6ZSI6MTAsImJvdHRvbSI6NDA5MzIsImNvbHVtbiI6ImlkIiwicGFnaW5hdGlvbklEIjo0MDEzMCwib3JkZXIiOjEsImZpbHRlcnMiOnsicGl0IjpudWxsLCJvb3QiOm51bGwsInFiIjp7IiRhbmQiOlt7IiRvciI6W3siJG1hdGNoIjp7InNvdXJjZSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJkZXN0aW5hdGlvbiI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtzb3VyY2VfcmVmZXJlbmNlX2lkXSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtkZXN0aW5hdGlvbl9yZWZlcmVuY2VfaWRdIjoiMTEwMDE4MjcxMDE3In19LHsiJG1hdGNoIjp7Im1ldGFkYXRhW2Rlc3RpbmF0aW9uX2FjY291bnRfbnVtYmVyXSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtzb3VyY2VfYWNjb3VudF9udW1iZXJdIjoiMTEwMDE4MjcxMDE3In19LHsiJG1hdGNoIjp7InNvdXJjZSI6IjExMDAxODI3MTAxNzpwZW5kaW5nIn19LHsiJG1hdGNoIjp7ImRlc3RpbmF0aW9uIjoiMTEwMDE4MjcxMDE3OnBlbmRpbmcifX0seyIkbWF0Y2giOnsic291cmNlIjoiMTEwMDE4MjcxMDE3OmhvbGQifX0seyIkbWF0Y2giOnsiZGVzdGluYXRpb24iOiIxMTAwMTgyNzEwMTc6aG9sZCJ9fV19LHsiJG1hdGNoIjp7Im1ldGFkYXRhW3R5cGVdIjoiTTJQX1BBWU9VVCJ9fV19LCJleHBhbmQiOlsidm9sdW1lcyJdLCJvcHRzIjpudWxsfSwicmV2ZXJzZSI6ZmFsc2V9
          headers: {}
          x-apidog-name: Payout
      security:
        - bearerAuth: []
          x-apidog:
            schemeGroups:
              - id: rfXlw0-kyPoJHieRfRNaN
                schemeIds:
                  - bearerAuth
            required: true
            use:
              id: rfXlw0-kyPoJHieRfRNaN
            scopes:
              rfXlw0-kyPoJHieRfRNaN:
                bearerAuth: []
      x-apidog-folder: Vrtx APIs/Transactions/Business Accounts
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1053095/apis/api-36885690-run
components:
  schemas: {}
  securitySchemes:
    bearerAuth:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      description: Enter your JWT access token for authentication
    bearerAuth1:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
    bearerAuth2:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      description: Enter your JWT access token for authentication
    bearerAuth3:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT issued by Keycloak. The client_id/azp in the token must map to a
        configured tenant (public, fai, neomrs; e.g., fai-sandbox -> fai) or
        requests will return 403.
    bearerAuth4:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      description: Enter your JWT access token for authentication
    bearer:
      type: http
      scheme: bearer
servers:
  - url: https://api.sandbox.vrtx.sa
    description: Sandbox
security:
  - bearer: []

```
