> ## Documentation Index > Fetch the complete documentation index at: https://v3.docs.derive.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Page a vault's pending withdrawal requests > Curator-only endpoint that returns a FIFO page of a vault's pending withdraw (burn) requests. Inputs are the vault subaccount and a page limit. Requires the curator mint-and-burn permission. ## OpenAPI ````yaml /openapi.json post /private/get_live_burn_requests openapi: 3.1.0 info: title: Derive v3 API version: 0.2.0 description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST. servers: - url: https://api.derive.xyz/v3 description: Production (HTTP POST base) - url: https://testnet.api.derive.xyz/v3 description: Testnet (HTTP POST base) security: [] tags: - name: Subaccounts description: >- List, inspect, and label subaccounts, portfolios, positions, and collateral. - name: Session Keys description: Register, edit, and list delegated signing keys. - name: Account description: Wallet-level account information and settings. - name: Orderbook description: Place, replace, cancel, and query orders, trigger orders, and algos. - name: RFQ description: 'Request-for-quote: send RFQs, quote, and execute block trades.' - name: Vault Shareholders description: >- Deposit into and withdraw from vaults, and track shares, requests, and performance. - name: Vault Curators description: >- Create and operate curated vaults: settle deposit and withdrawal requests, and manage vault metadata. - name: History description: >- Per-account historical records: orders, trades, transfers, and settlements. - name: Market Maker Protection description: Configure, read, and reset market-maker protection. - name: Transfers & Withdrawals description: Move collateral between subaccounts, to other wallets, and on-chain. - name: System description: Rate limits and transaction lookups. - name: Market Data description: Instruments, currencies, tickers, and market-wide feeds. - name: Referrals description: Referral codes and program performance. - name: Other description: Uncategorized. paths: /private/get_live_burn_requests: post: tags: - Vault Curators summary: Page a vault's pending withdrawal requests description: >- Curator-only endpoint that returns a FIFO page of a vault's pending withdraw (burn) requests. Inputs are the vault subaccount and a page limit. Requires the curator mint-and-burn permission. operationId: private_get_live_burn_requests requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GetLiveBurnRequestsRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/MultipleVaultRequestsResponse' default: description: JSON-RPC error (see Error Codes) components: schemas: GetLiveBurnRequestsRequest: type: object required: - limit - subaccount_id properties: limit: type: integer format: uint64 minimum: 0 subaccount_id: type: integer format: uint64 minimum: 0 MultipleVaultRequestsResponse: description: >- Returned by `get_live_mint_requests` / `get_live_burn_requests`: a FIFO page plus the queue's total live length (so the caller can paginate). type: object required: - requests - total properties: requests: type: array items: $ref: '#/components/schemas/VaultRequestResponse' total: type: integer format: uint64 minimum: 0 VaultRequestResponse: description: One queued deposit/withdraw request as surfaced to the curator. type: object required: - creation_timestamp_ms - id - signed_action - subaccount_id - user_action_hash - wallet properties: creation_timestamp_ms: type: integer format: uint64 minimum: 0 id: $ref: '#/components/schemas/VaultRequestId' signed_action: $ref: '#/components/schemas/SignedAction' description: >- The user's signed deposit/withdraw envelope; the curator pairs their `MintShares`/`BurnShares` approval against it. subaccount_id: type: integer format: uint64 minimum: 0 user_action_hash: description: >- 0x-prefixed hex of the 32-byte user-action hash the curator commits to. type: string wallet: $ref: '#/components/schemas/Address' VaultRequestId: description: |- Composite vault request id: `(vault_subaccount_id, wallet, vault_nonce)` Useful as a stable dedup key across off-chain and on-chain vault events. type: object required: - vault_nonce - vault_subaccount_id - wallet properties: vault_nonce: type: string vault_subaccount_id: type: integer format: uint64 minimum: 0 wallet: $ref: '#/components/schemas/Address' SignedAction: description: 'An Action bundled with its ECDSA signature (65 bytes: r||s||v).' type: object required: - action - signature properties: action: $ref: '#/components/schemas/Action' description: The signed action envelope. signature: description: 65-byte ECDSA signature (r||s||v). type: array items: type: integer format: uint8 minimum: 0 Address: description: 20-byte Ethereum address as a 0x-prefixed lowercase hex string. type: string maxLength: 42 minLength: 42 pattern: ^0x[0-9a-fA-F]{40}$ Action: description: >- EIP-712 typed-data Action struct that you sign; its fields are defined below. type: object required: - data - expiry - module - nonce - owner - signer - subaccount_id properties: data: description: ABI-encoded action data (`bytes`). type: array items: type: integer format: uint8 minimum: 0 expiry: description: Unix timestamp after which the action is invalid (`uint256`). type: integer format: uint64 minimum: 0 module: $ref: '#/components/schemas/Address' description: Module address that will process this action (`address`). nonce: description: >- Replay-protection nonce (`uint256`), interpreted as a UTC-**nanosecond** timestamp: it must fall within the nonce validity window (one day) of the action's timestamp. type: integer format: uint64 minimum: 0 owner: $ref: '#/components/schemas/Address' description: Owner of the subaccount (`address`). signer: $ref: '#/components/schemas/Address' description: Address that signed this action (`address`). subaccount_id: description: Subaccount identifier (`uint256`). type: integer format: uint64 minimum: 0 ```` ## Related topics - [Page a vault's pending deposit requests](/api-reference/vault-curators/page-a-vaults-pending-deposit-requests.md) - [List a wallet's pending vault requests](/api-reference/vault-shareholders/list-a-wallets-pending-vault-requests.md) - [Reject a pending vault deposit request](/api-reference/vault-curators/reject-a-pending-vault-deposit-request.md)