> ## Documentation Index > Fetch the complete documentation index at: https://developers.circle.com/llms.txt > Use this file to discover all available pages before exploring further. # List all account bank withdrawals > Lists all bank withdrawals for accounts. ## OpenAPI ````yaml openapi/accounts.yaml get /v1/accounts/withdrawals openapi: 3.0.2 info: version: 1.0.0 title: Accounts (Stablecoin) API description: > Circle's Accounts API provides endpoints for managing stablecoin accounts -- including transfers, withdrawals, deposits, wire and ACH bank accounts, and blockchain addresses. An **Account** is a general representation of a ledger or custody object that holds balances. It can be a business account, a stablecoin account ledger for an end user, an extra sub-ledger, or any future custody solution. license: name: Circle License url: https://circle.com/terms servers: - url: https://api-sandbox.circle.com - url: https://api.circle.com security: [] tags: - name: Accounts description: Manage accounts. - name: Account Groups description: Manage custody account groups and their memberships. - name: Transactions description: | Get a unified, customer-friendly view of account transaction activity. - name: Transfers description: Manage account transfers. - name: Withdrawals description: Manage account bank withdrawals (fiat offramp). - name: Wires description: Manage account bank accounts for wire transfers. - name: ACH description: Manage account bank accounts for ACH transfers. - name: Deposits description: Get information on account bank deposits. - name: Deposit Addresses description: Manage account deposit addresses. - name: Recipient Addresses description: Manage account recipient addresses used for transfers. paths: /v1/accounts/withdrawals: get: tags: - Withdrawals summary: List all account bank withdrawals description: Lists all bank withdrawals for accounts. operationId: listAccountWithdrawals parameters: - $ref: '#/components/parameters/AccountId' - name: status description: >- Queries items with the specified status. Matches any status if unspecified. in: query required: false schema: type: array uniqueItems: true items: $ref: '#/components/schemas/PayoutStatus' - $ref: '#/components/parameters/From' - $ref: '#/components/parameters/To' - $ref: '#/components/parameters/PageBefore' - $ref: '#/components/parameters/PageAfter' - $ref: '#/components/parameters/PageSize' responses: '200': description: Successfully retrieved a list of withdrawals. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: $ref: '#/components/schemas/ListAccountWithdrawalsResponse' '401': $ref: '#/components/responses/NotAuthorized' '500': $ref: '#/components/responses/InternalServerError' security: - bearerAuth: [] components: parameters: AccountId: name: accountId description: >- Identifier of the account. Filters results to fetch only resources associated with the specified account. in: query required: false schema: type: string example: '1000565227' From: name: from description: >- Queries items created since the specified date-time (inclusive) in ISO 8601 format. in: query required: false schema: $ref: '#/components/schemas/UtcTimestamp' To: name: to description: >- Queries items created before the specified date-time (inclusive) in ISO 8601 format. in: query required: false schema: $ref: '#/components/schemas/UtcTimestamp' PageBefore: name: pageBefore description: >- A collection ID value used for pagination. It marks the exclusive end of a page. When provided, the collection resource will return the next `n` items before the id, with `n` being specified by `pageSize`. in: query required: false schema: type: string example: def9520a-5280-4089-9b02-3c9ef8fc8514 PageAfter: name: pageAfter description: >- A collection ID value used for pagination. It marks the exclusive beginning of a page. When provided, the collection resource will return the next `n` items after the id, with `n` being specified by `pageSize`. in: query required: false schema: type: string example: bce1e961-bdb8-4983-a9c2-0b3fbc2614cf PageSize: name: pageSize description: > Limits the number of items to be returned. Some collections have a strict upper bound that will disregard this value. In case the specified value is higher than the allowed limit, the collection limit will be used. If omitted, the collection will determine the page size itself. in: query required: false schema: type: integer minimum: 1 example: 5 schemas: PayoutStatus: type: string description: >- Status of the payout. Status `pending` indicates that the payout is in process; `complete` indicates it finished successfully; `failed` indicates it failed. enum: - pending - complete - failed ListAccountWithdrawalsResponse: title: ListAccountWithdrawalsResponse properties: data: type: array items: $ref: '#/components/schemas/BusinessPayout' UtcTimestamp: type: string description: ISO-8601 UTC date/time format. example: '2020-04-10T02:13:30.000Z' XRequestId: type: string format: uuid example: 2adba88e-9d63-44bc-b975-9b6ae3440dde BusinessPayout: type: object properties: id: $ref: '#/components/schemas/Id' sourceAccountId: type: string description: Identifier of the source account. destination: $ref: '#/components/schemas/BankDestination' amount: $ref: '#/components/schemas/FiatMoney' toAmount: $ref: '#/components/schemas/FiatPayoutToMoney' fees: $ref: '#/components/schemas/FiatMoneyUsd' status: $ref: '#/components/schemas/PayoutStatus' trackingRef: type: string nullable: true description: >- Payout tracking reference. This is only available once the payout has been successfully submitted to the bank. errorCode: $ref: '#/components/schemas/PayoutErrorCode' externalRef: $ref: '#/components/schemas/Id' riskEvaluation: $ref: '#/components/schemas/RiskEvaluation' adjustments: $ref: '#/components/schemas/FinalAdjustments' return: $ref: '#/components/schemas/UnwithdrawalObject' description: type: string description: > A free-form description echoed from the original create request. Omitted when unset. nullable: true customerExternalRef: type: string description: > Customer-supplied external reference echoed back on the response and on payout webhooks. Useful for correlating payouts with external systems. Omitted when unset. nullable: true createDate: $ref: '#/components/schemas/UtcTimestamp' updateDate: $ref: '#/components/schemas/UtcTimestamp' Error: type: object required: - code - message properties: code: type: integer description: > Circle internal status code from the platform `CoreStatusCode` enum (and its domain-specific extensions). **This is not the HTTP status code** — `-1` is the catch-all unknown error, `1`/`2` indicate API parameter problems, `3` is forbidden, `4` is unauthorized, and larger values identify domain-specific failures. Consumers should rely on the HTTP status line for transport-level error class and on this field for the specific Circle error case. example: 2 message: type: string description: >- Internal error message; suitable for logging but not for end-user display. example: API parameter invalid. externalMessage: type: string description: > End-user-displayable error message. Present when the server has generated a customer-facing variant for this error; omitted otherwise. example: The provided amount exceeds the maximum allowed. Id: type: string description: Unique system-generated identifier for the entity. format: uuid example: b8627ae8-732b-4d25-b947-1df8f4007a29 BankDestination: type: object description: The destination bank account. required: - type - id properties: type: $ref: '#/components/schemas/BusinessAccountPayoutDestinationType' id: type: string description: > The ID of a bank account created via [POST /v1/banks/wires](#operation/createWireAccount). format: uuid example: b8627ae8-732b-4d25-b947-1df8f4007a29 name: type: string description: Bank name plus last four digits of the bank account number or IBAN. example: COMMERZBANK AG ****3000 FiatMoney: type: object required: - amount - currency properties: amount: type: string description: Magnitude of the amount, in units of the currency, with a `.`. example: '3.14' currency: $ref: '#/components/schemas/FiatCurrency' FiatPayoutToMoney: type: object required: - currency properties: amount: description: Magnitude of the amount, in units of the currency, with a `.`. type: string example: '3.14' readOnly: true currency: $ref: '#/components/schemas/FiatCurrency' FiatMoneyUsd: type: object required: - amount - currency properties: amount: type: string description: Magnitude of the amount, in units of the currency, with a `.`. example: '3.14' currency: description: Currency code. type: string enum: - USD PayoutErrorCode: type: string nullable: true description: >- Indicates the failure reason of a payout. Only present for payouts in a failed state. enum: - insufficient_funds - transaction_denied - transaction_failed - transaction_returned - bank_transaction_error - fiat_account_limit_exceeded - invalid_bank_account_number - invalid_ach_rtn - invalid_wire_rtn - vendor_inactive - payout_canceled - invalid_travel_rule_identity - intermediary_bank_required - sen_not_supported RiskEvaluation: type: object description: >- Results of risk evaluation. Only present if the payment is denied by Circle's risk service. nullable: true properties: decision: description: Enumerated decision of the account. type: string enum: - approved - denied - review reason: description: Risk reason for the definitive decision outcome. type: string nullable: true example: '3000' FinalAdjustments: type: object description: >- Final adjustment which increases (credits) or decreases (debits) the total returned amount to the source wallet. nullable: true properties: fxCredit: $ref: '#/components/schemas/FiatMoneyUsd' fxDebit: $ref: '#/components/schemas/FiatMoneyUsd' UnwithdrawalObject: type: object description: >- Return information if the payout is returned by the bank. Only present if `errorCode` of payout is `transaction_returned`. nullable: true properties: id: $ref: '#/components/schemas/Id' payoutId: type: string description: >- Universally unique identifier (UUID v4) of the payout that is associated with the return. format: uuid example: abdb500d-4a59-457c-801f-2d418c8703ac amount: $ref: '#/components/schemas/FiatMoneyUsd' fees: $ref: '#/components/schemas/FiatMoneyUsd' reason: type: string description: Reason for the return. example: payout_returned status: type: string description: Status of the return. enum: - pending - complete - failed createDate: $ref: '#/components/schemas/UtcTimestamp' updateDate: $ref: '#/components/schemas/UtcTimestamp' BusinessAccountPayoutDestinationType: type: string description: The destination bank account type. enum: - wire FiatCurrency: type: string description: Currency code. title: Currency enum: - USD - EUR example: USD headers: XRequestId: description: > Circle-generated universally unique identifier (UUID v4). Useful for identifying a specific request when communicating with Circle Support. schema: $ref: '#/components/schemas/XRequestId' responses: NotAuthorized: description: >- The request has not been applied because it lacks valid authentication credentials. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: code: 4 message: Unauthorized. InternalServerError: description: >- The server encountered an unexpected condition that prevented it from fulfilling the request. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: code: -1 message: 'Something went wrong. errId: 1f0b0c455e40f753f07b4f0ae6abd4b4' securitySchemes: bearerAuth: type: http scheme: bearer ````