> ## Documentation Index > Fetch the complete documentation index at: https://docs.groundtech.co/llms.txt > Use this file to discover all available pages before exploring further. # Get a requested redemption > Returns liquidation progress, actual attributable proceeds, the fixed receiver, and underlying source operations for one asynchronous redemption request. Read liquidation, claim availability, and actual attributable proceeds for a requested redemption. ## OpenAPI ````yaml swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/redemptions/{requestId} openapi: 3.0.0 info: title: Ground API description: Core API for Portfolio Wallets, gtokens, MicroVaults, and webhooks. version: 2.0.0 servers: - url: https://sandbox.groundtech.co - url: https://production.groundtech.co security: - bearerAuth: [] tags: - name: System description: System health and utility endpoints. - name: Sandbox Faucets description: Sandbox-only test token faucets. - name: Portfolio Wallets description: >- Portfolio wallets with strategy allocation, deposits, withdrawals, and yield positions. - name: gVaults description: >- Direct access to gtokens with deposit access controls and optional fee wrappers. - name: MicroVaults description: >- Customer-owned onchain vaults with externally held ERC-20 shares. Private preview in sandbox on Ethereum Sepolia. - name: Webhook Endpoints description: Webhook endpoint management for portfolio wallet notifications. paths: /v2/microvaults/vaults/{vaultId}/redemptions/{requestId}: parameters: - name: vaultId in: path required: true schema: $ref: '#/components/schemas/UuidV4' description: >- Ground identifier of the MicroVault that accepted the redemption request. - name: requestId in: path required: true schema: $ref: '#/components/schemas/MicroVaultUint256' description: >- Onchain request identifier returned when an asynchronous redemption is submitted. get: tags: - MicroVaults summary: Get a requested redemption description: >- Returns liquidation progress, actual attributable proceeds, the fixed receiver, and underlying source operations for one asynchronous redemption request. operationId: getMicrovaultRedemption responses: '200': description: Requested-redemption progress and actual proceeds. content: application/json: schema: $ref: '#/components/schemas/MicroVaultRedemptionResponse' '401': $ref: '#/components/responses/Unauthorized' '404': description: Redemption not found. content: application/json: schema: $ref: '#/components/schemas/MicroVaultError' components: schemas: UuidV4: type: string format: uuid pattern: >- ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$ example: 8f4c52d7-62ab-4db9-a964-92f481f6b851 MicroVaultUint256: type: string pattern: ^(0|[1-9][0-9]*)$ description: Unsigned base-10 integer in token base units. example: '1000000' MicroVaultRedemptionResponse: type: object required: - redemption properties: redemption: type: object additionalProperties: true description: >- Current state, amounts, participants, and source progress for one requested redemption. required: - id - requestId - status - owner - receiver - shares - estimatedAssets - actualAssets - reservedAssets - createdAt - updatedAt - sourceOperations properties: id: allOf: - $ref: '#/components/schemas/UuidV4' description: Ground record identifier for this redemption. requestId: allOf: - $ref: '#/components/schemas/MicroVaultUint256' description: Onchain redemption request identifier. status: type: string enum: - pending - fulfilling - claimable - claimed - cancelled description: Current request, liquidation, or claim state. owner: allOf: - $ref: '#/components/schemas/NonzeroEvmAddress' description: Wallet whose shares were reserved for this redemption. receiver: allOf: - $ref: '#/components/schemas/NonzeroEvmAddress' description: >- Fixed wallet that receives the base asset when the request is claimed. shares: allOf: - $ref: '#/components/schemas/MicroVaultUint256' description: Shares reserved for redemption in 18-decimal share-token units. estimatedAssets: allOf: - $ref: '#/components/schemas/MicroVaultUint256' nullable: true description: Base-asset estimate when the request was planned. actualAssets: allOf: - $ref: '#/components/schemas/MicroVaultUint256' nullable: true description: >- Actual attributable base-asset proceeds once the request is claimable or claimed. reservedAssets: allOf: - $ref: '#/components/schemas/MicroVaultUint256' description: Idle base assets already reserved for this request. createdAt: type: string format: date-time description: Time when the request was observed. updatedAt: type: string format: date-time description: Time when the request or source progress last changed. sourceOperations: type: array items: type: object additionalProperties: true description: Underlying yield-source exits and their processing estimates. example: redemption: id: 74e764d0-98e2-4ab7-99f7-d7ca2fe04a44 requestId: '12' status: claimable owner: '0x76f8fc6667e239f83a547d4e16225d6a34f6fa22' receiver: '0x76f8fc6667e239f83a547d4e16225d6a34f6fa22' shares: '5000000000000000000' estimatedAssets: '5000000' actualAssets: '4998100' reservedAssets: '1000000' createdAt: '2026-09-10T18:41:00.000Z' updatedAt: '2026-09-11T18:41:00.000Z' sourceOperations: - id: d01a0996-0ee3-41e5-a582-ad1a60cbe07d operationId: '7' sourceId: >- 0x1111111111111111111111111111111111111111111111111111111111111111 sourceName: Invesco USTB sourceTicker: USTB status: claimable expectedProcessingSeconds: 86400 maxProcessingSeconds: 259200 assets: '3998100' MicroVaultError: type: object required: - error properties: error: type: string example: invalid_request description: Stable machine-readable error code. message: type: string nullable: true example: allocation targets and idleTargetBps must total 10000 description: >- Human-readable explanation of why the request failed, when available. details: nullable: true description: Structured context for the error, when available. example: error: invalid_request message: allocation targets and idleTargetBps must total 10000 NonzeroEvmAddress: type: string description: >- Valid nonzero EVM EOA or contract address. Mixed-case values must use a valid EIP-55 checksum. minLength: 42 maxLength: 42 pattern: ^0x(?!0{40}$)[0-9a-fA-F]{40}$ example: '0x3bf25a73a1f1033c2d50ac65f3c9d6a44123db81' AuthErrorResponse: type: object required: - error properties: error: type: string description: Authentication or authorization error message. message: type: string nullable: true description: Additional auth middleware detail, when present. code: type: string nullable: true enum: - unauthenticated - forbidden description: >- Some auth and scope failures include a stable code; middleware errors may omit it. responses: Unauthorized: description: >- The request is missing a valid bearer token, or the token is invalid or expired. content: application/json: schema: $ref: '#/components/schemas/AuthErrorResponse' example: error: Unauthenticated request message: Missing or invalid bearer token securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````