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

# List fiat withdrawal accounts

> Returns a paginated list of approved fiat bank accounts available as withdrawal destinations.

Returns a paginated list of all approved fiat withdrawal accounts for the organization. Results include bank name, account details, routing/SWIFT codes, transfer type, and verification status.

Use this endpoint to:

* Review the bank accounts approved as fiat withdrawal destinations
* Look up an account's ID before initiating a fiat withdrawal
* Confirm an account's verification and active status

## Errors

| Status | Message                                                                         | Notes                                                       |
| ------ | ------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| 400    | `Query validation failed`                                                       | Request didn't match schema                                 |
| 401    | `The authorization key provided is either invalid or expired, please try again` | Mint a fresh JWT — see [Authentication](/v2/authentication) |
| 409    | `Request with this idempotency key is currently processing`                     | See [Errors → Idempotency](/v2/errors#idempotency-errors)   |
| 422    | `Idempotency key reused with different parameters`                              | New body → new key                                          |
| 500    | `An internal error has occurred`                                                | Server fault; retry with backoff                            |

See the full [v2 error reference](/v2/errors) for retry semantics and idempotency-specific codes.


## OpenAPI

````yaml GET /v2/brokerage/{orgId}/fiat_withdrawal_addresses
openapi: 3.1.0
info:
  title: Overview of OpenFX APIs
  description: >-
    OpenFX provides a robust and secure API suite engineered for high
    performance and reliability, enabling programmatic access to real-time
    market data, trade execution, and money movement functionalities. This guide
    will walk through the step-by-step process of deposits, quoting, trading,
    settlements and monitoring using OpenFX APIs.
  version: v2.0.0
  termsOfService: https://www.openfx.com/terms
  contact:
    name: OpenFX Support
    email: support@openfx.com
    url: https://www.openfx.com
servers:
  - url: https://api.openfx.com
    description: OpenFX API Server
security:
  - bearerAuth: []
tags:
  - name: MarketData
    description: >-
      This endpoint retrieves a complete list of all tradable fiat and
      stablecoin currency pairs on the OpenFX platform.
  - name: Balances
    description: >-
      The Balance endpoints enable real-time tracking and management of currency
      holdings within an account.
  - name: Trade
    description: >-
      The Trade APIs facilitate programmatic currency exchange through a
      quote-then-trade workflow, ensuring price transparency and guaranteed
      execution at quoted rates.
  - name: Deposits
    description: >-
      Deposit endpoints enable secure funding of trading accounts across
      multiple supported currencies and methods.
  - name: Withdrawals
    description: >-
      The Withdrawal API facilitates secure fund withdrawals for both fiat and
      stablecoins.
paths:
  /v2/brokerage/{orgId}/fiat_withdrawal_addresses:
    get:
      tags:
        - Withdrawals
      summary: List withdrawal accounts
      description: >-
        This endpoint is used to get a complete list of all approved fiat
        withdrawal accounts for an organization. The responses have pagination
        included to help navigate through multiple accounts if needed.
      operationId: listFiatWithdrawalAccounts
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type:
              - number
              - 'null'
            minimum: 1
            example: 1
          example: 1
        - name: limit
          in: query
          required: false
          schema:
            type:
              - number
              - 'null'
            minimum: 1
            maximum: 50
            example: 10
          example: 10
        - schema:
            type: string
          in: path
          name: orgId
          required: true
      responses:
        '200':
          description: success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                      - error
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          example: 62389a49-7f17-49ab-ac2e-e1947961614e
                          description: Unique identifier for the fiat withdrawal account
                        currency:
                          type: string
                          example: USD
                          description: Currency symbol associated with the account
                        accountName:
                          type: string
                          example: testing USD
                          description: Name associated with the bank account
                        accountNumber:
                          type: string
                          example: '1234'
                          description: Bank account number or its masked representation
                        bankName:
                          type: string
                          example: USD TESTING
                          description: Name of the bank where the account is held
                        routingNumber:
                          type:
                            - string
                            - 'null'
                          example: '23423556'
                          description: >-
                            Routing number for the bank, applicable for certain
                            countries
                        swiftCode:
                          type:
                            - string
                            - 'null'
                          example: null
                          description: SWIFT/BIC code for international transfers
                        status:
                          type: string
                          enum:
                            - active
                            - pending
                            - rejected
                            - deactivated
                            - additional_action_needed
                            - archived
                          example: active
                          description: Current status of the withdrawal account
                        verified:
                          type: boolean
                          example: true
                          description: Indicates whether the account has been verified
                        creatorId:
                          type:
                            - string
                            - 'null'
                          format: uuid
                          example: 84677558-407c-4ee9-b59a-51a0d5f55764
                          description: User ID of the account creator (nullable)
                        orgId:
                          type: string
                          format: uuid
                          example: c96183a5-2830-4606-9ae2-15dfd058872b
                          description: Organization ID to which this account belongs
                        transferType:
                          type: string
                          examples:
                            - ACH
                            - WIRE
                          description: Chosen transfer type of the account
                        memo:
                          type:
                            - string
                            - 'null'
                          example: null
                          description: >-
                            Optional memo field for the account, will be null if
                            it is unset
                        createdAt:
                          type: string
                          example: '2024-10-24T21:20:21.814Z'
                          description: UTC Timestamp when the account was created
                        updatedAt:
                          type: string
                          example: '2024-10-25T03:14:56.998Z'
                          description: UTC Timestamp when the account was last updated
                  message:
                    type: string
                    example: Data fetched successfully
                  meta:
                    type: object
                    properties:
                      pagination:
                        type: object
                        properties:
                          total:
                            type: number
                            example: 10
                          start:
                            type: number
                            example: 1
                          end:
                            type: number
                            example: 2
                          page:
                            type: number
                            example: 1
                          limit:
                            type: number
                            example: 2
              examples:
                default_example:
                  value:
                    status: success
                    data:
                      - id: d811ed6a-62c4-403f-bbe8-81d39f6d21c7
                        currency: USD
                        accountName: USD FEDWIRE
                        accountNumber: '123456789'
                        bankName: Zand
                        routingNumber: '1234567'
                        swiftCode: null
                        status: active
                        verified: true
                        creatorId: 84677558-407c-4ee9-b59a-51a0d5f55764
                        orgId: c96183a5-2830-4606-9ae2-15dfd058872b
                        transferType: FEDWIRE
                        memo: null
                        createdAt: '2024-08-28T02:25:14.926Z'
                        updatedAt: '2024-10-10T05:28:40.340Z'
                      - id: 66c3ef64-1fa6-4512-b083-57090e08ea57
                        currency: GBP
                        accountName: GBP SWIFT3
                        accountNumber: '1234'
                        bankName: GBP SWIFT3
                        routingNumber: null
                        swiftCode: '2343'
                        status: active
                        verified: true
                        creatorId: 84677558-407c-4ee9-b59a-51a0d5f55764
                        orgId: c96183a5-2830-4606-9ae2-15dfd058872b
                        transferType: SWIFT
                        memo: null
                        createdAt: '2024-09-04T08:30:50.601Z'
                        updatedAt: '2024-10-10T05:30:49.044Z'
                    meta:
                      pagination:
                        total: 2
                        start: 1
                        end: 2
                        page: 1
                        limit: 2
        '400':
          description: Bad Request
          content:
            application/json:
              examples:
                default_example:
                  value:
                    status: error
                    message: Query validation failed
        '401':
          description: Unauthorized
          content:
            application/json:
              examples:
                default_example:
                  value:
                    status: error
                    message: >-
                      The authorization key provided is either invalid or
                      expired, please try again
        '409':
          description: Conflict
          content:
            application/json:
              examples:
                default_example:
                  value:
                    status: error
                    message: Request with this idempotency key is currently processing
                    error:
                      code: IDEMPOTENCY_IN_FLIGHT
                      details: Please wait for the original request to complete
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              examples:
                default_example:
                  value:
                    status: error
                    message: Idempotency key reused with different parameters
                    error:
                      code: IDEMPOTENCY_MISMATCH
                      details: >-
                        This idempotency key was already used with different
                        request parameters
        '500':
          description: Internal Server Error
          content:
            application/json:
              examples:
                default_example:
                  value:
                    status: error
                    message: An internal error has occurred
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````