Depositors

Get depositor pending redemptions

Get pending redemption requests across all vaults for a given depositor controller address. If networkId is omitted, results span all chains. Requires authentication.

get/v3/depositors/pending-redemptions

Request

  • Base URL: https://api.creditcoop.xyz
  • URL: https://api.creditcoop.xyz/v3/depositors/pending-redemptions
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://clerk.creditcoop.xyz/oauth/authorize, token URL https://clerk.creditcoop.xyz/oauth/token)

Query parameters

protocolVersionstring[]

Filter by protocol version(s). Comma-separated or repeated (e.g. ?protocolVersion=v1,v2 or ?protocolVersion=v1&protocolVersion=v2). Omit to return all versions.

addressstring required

Depositor controller address to look up pending redemptions for. The controller is the address that initiated the ERC-7540 async request (pendingDepositRequest / pendingRedeemRequest) and may differ from the eventual share owner — e.g. a smart wallet or router acting on a user's behalf. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

vaultAddressstring

Filter to a specific vault address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

networkIdstring

CAIP-2 network ID (e.g., "eip155:1", "eip155:8453"). If omitted, results span all chains.

Response

Default Response

controllerAddressstring required

ERC-7540 controller address — the account that initiated the async deposit/redeem request. May differ from the eventual share owner.

Example response

{
  "controllerAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "pendingRedemptions": [
    {
      "vaultId": "550e8400-e29b-41d4-a716-446655440000",
      "vaultAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "networkId": "eip155:1",
      "shareToken": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    }
  ],
  "claimableRedemptions": [
    {
      "vaultId": "550e8400-e29b-41d4-a716-446655440000",
      "vaultAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "networkId": "eip155:1",
      "shareToken": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.