> ## Documentation Index > Fetch the complete documentation index at: https://docs.compasslabs.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get IXS vault redemption requests for an owner > Get an owner's IXS vault redemption requests (async redemption status). IXS managed-vault **sells** are asynchronous: `/transact/sell` returns a `requestRedeem` transaction, and the vault operator settles it off-chain later. This endpoint reconstructs the owner's requests directly from the vault on every call (Compass persists no async state) — each entry carries its `status` (`pending` | `finalized` | `rejected`), the `shares` requested, and, while `pending`, the `expected_net_assets` it would settle for at the current NAV (a preview, not a guarantee). IXS vaults live on BNB Smart Chain — pass `chain=bsc` (the default) and the `vault` handle (default `ixv1`). ## OpenAPI ````yaml /v2/combined_spec.json get /v2/tokenized_assets/redemptions openapi: 3.1.0 info: title: Compass API description: Compass Labs DeFi API version: 0.0.1 servers: - url: https://api.compasslabs.ai description: Production server security: - ApiKeyAuth: [] paths: /v2/tokenized_assets/redemptions: get: tags: - Tokenized Assets summary: Get IXS vault redemption requests for an owner description: >- Get an owner's IXS vault redemption requests (async redemption status). IXS managed-vault **sells** are asynchronous: `/transact/sell` returns a `requestRedeem` transaction, and the vault operator settles it off-chain later. This endpoint reconstructs the owner's requests directly from the vault on every call (Compass persists no async state) — each entry carries its `status` (`pending` | `finalized` | `rejected`), the `shares` requested, and, while `pending`, the `expected_net_assets` it would settle for at the current NAV (a preview, not a guarantee). IXS vaults live on BNB Smart Chain — pass `chain=bsc` (the default) and the `vault` handle (default `ixv1`). operationId: v2_tokenized_assets_redemptions parameters: - name: owner in: query required: true schema: type: string title: Owner default: '0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B' description: >- The owner of the Tokenized Assets Account whose IXS redemption requests to read. Requests are reconstructed on-chain from the derived product account (the request receiver). - name: chain in: query required: false schema: type: string enum: - base - ethereum - arbitrum - hyperevm - tempo - bsc title: Chain description: The chain to use. default: bsc description: >- Network the IXS vault lives on (IXS managed vaults are on BNB Smart Chain). - name: vault in: query required: false schema: type: string default: ixv1 title: Vault description: The IXS vault handle to read redemptions for (e.g. 'ixv1'). responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/RedemptionsResponse' '422': description: >- `NOT_AN_IXS_VAULT` — no IXS vault with the given `vault` handle is registered on the requested `chain`. content: application/json: schema: $ref: '#/components/schemas/TokenizedAssetsErrorResponse' x-codeSamples: - lang: python label: Python (SDK) source: |- from compass_api_sdk import CompassAPI, models with CompassAPI( api_key_auth="", ) as compass_api: res = compass_api.tokenized_assets.tokenized_assets_redemptions(owner="0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B", chain=models.V2TokenizedAssetsRedemptionsChain.BSC, vault="ixv1") # Handle response print(res) - lang: typescript label: Typescript (SDK) source: |- import { CompassApiSDK } from "@compass-labs/api-sdk"; const compassApiSDK = new CompassApiSDK({ apiKeyAuth: "", }); async function run() { const result = await compassApiSDK.tokenizedAssets.tokenizedAssetsRedemptions({ owner: "0x29F20a192328eF1aD35e1564aBFf4Be9C5ce5f7B", chain: "bsc", vault: "ixv1", }); console.log(result); } run(); components: schemas: RedemptionsResponse: properties: redemptions: items: $ref: '#/components/schemas/Redemption' type: array title: Redemptions description: >- The owner's non-empty redemption requests for the vault, in ascending id order. Empty when the owner has never requested one. default: [] type: object title: RedemptionsResponse description: An owner's IXS redemption requests for one vault. TokenizedAssetsErrorResponse: properties: error: type: string title: Error description: >- Short human-readable error label (e.g. `Market not found.`, `Insufficient liquidity`, `Order not found.`). message: type: string title: Message description: Human-readable explanation. type: object required: - error - message title: TokenizedAssetsErrorResponse description: >- Standard error envelope returned by every non-2xx response. Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Redemption: properties: id: type: integer title: Id description: On-chain redemption request id. status: type: string enum: - pending - finalized - rejected - unknown title: Status description: >- Lifecycle state: `pending` (awaiting operator settlement), `finalized` (settled — assets paid to the product account), `rejected` (operator declined; shares returned to the account), or `unknown` (an unrecognized on-chain status code — should not occur for the current contract, surfaced defensively instead of erroring). shares: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Shares description: Vault shares in the request (human units). expected_net_assets: anyOf: - type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ - type: 'null' title: Expected Net Assets description: >- For a `pending` request, the estimated net assets (after the exit fee) it would settle for at the current NAV — a preview, not a guarantee (settlement depends on the operator and the vault's available assets). Null once finalized or rejected. requested_at: type: integer title: Requested At description: Unix timestamp when the redemption was requested. processed_at: anyOf: - type: integer - type: 'null' title: Processed At description: Unix timestamp when finalized/rejected; null while pending. type: object required: - id - status - shares - requested_at title: Redemption description: One IXS vault redemption request, reconstructed on-chain. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your Compass API Key. Get your key [here](https://www.compasslabs.ai/dashboard). ````