---
title: "Search deposit addresses by different fields"
method: GET
path: "/deposit-addresses/search"
tags: ["depositAddresses"]
---

# Search deposit addresses by different fields

`GET /deposit-addresses/search`

Returns the deposit addresses that match the given search criteria.

## Query parameters

- `addressNote` string — Optional note or label for the deposit address (max 80 characters).
- `depositChain` string — The blockchain network identifier where the deposit address is located.
- `destinationChain` string — The blockchain network identifier where bridged tokens will be sent.
- `destinationAddress` string — a non empty string
- `pageToken` string — a non empty string
- `pageSize` string — a string to be decoded into a number

## Response `200`

SearchDepositAddressResponse

- SearchDepositAddressResponse
  - `nextPageToken` string, required — a non empty string
  - `items` object[], required — Array of deposit addresses matching the search criteria.
    - `depositChain` string, required — The blockchain network identifier where the deposit address is located.
    - `depositAddress` string, required — The generated deposit address where users should send tokens.
    - `destinationChain` string, required — The blockchain network identifier where bridged tokens will be sent.
    - `destinationAddress` string — a non empty string
    - `addressNote` string — a string at most 80 character(s) long
    - `isPaused` boolean, required — Whether this deposit address is currently paused. Paused addresses reject incoming deposits until they are unpaused.
    - `postBridgeData` union
      - ExtendedPostBridgeData
        - `_tag` 'extended', required
        - `vaultId` integer, required — an integer
      - StarkwareBtcfiCampaignPostBridgeData
        - `_tag` 'starkwarebtcfi', required
      - WirexWrapPostBridgeData
        - `_tag` 'wirexwrap', required
      - WirexWrapSandboxPostBridgeData
        - `_tag` 'wirexwrapsandbox', required
      - StarkwareBtcfiCampaignV2PostBridgeData
        - `_tag` 'starkwarebtcfiv2', required
        - `spans` StarknetFelt[], required — an array of at most 70 item(s)
      - AaveV3SupplyPostBridgeData
        - `_tag` 'aavev3supply', required
      - RocketFoundationDepositPostBridgeData
        - `_tag` 'rocketfoundationdeposit', required
      - MapleDepositPostBridgeData
        - `_tag` 'mapledeposit', required
    - `tokenOut` string
    - `refundAddress` string — a non empty string
    - `bridgeIfNotSwappable` boolean
    - `chainMetadata` ChainMetadata — Optional chain-specific metadata. Currently only populated for Stellar SDAs, where it exposes the base address and memo id that the muxed deposit address resolves to.
      - `_tag` 'STELLAR', required
      - `baseAddress` string, required
      - `memoId` string, required
    - `_tag` 'legacy'
    - `userId` string, required
    - `webhookUrl` string — a non empty string

## Other responses

- `400` — The request did not match the expected schema
- `401` — Unauthorized
- `422` — InvalidRequest

---

[API](https://skmtc.net/rhino/apis/bridge-api.md) · [All operations](https://skmtc.net/rhino/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rhino/bridge-api/versions/fb4dd5f3c1b3/schema)