---
title: "Look up a vault account by blockchain address"
method: GET
path: "/vault/lookup_by_address"
tags: ["Vaults"]
---

# Look up a vault account by blockchain address

`GET /vault/lookup_by_address`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/vault/lookup_by_address`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/vault/lookup_by_address/get.ts> (a function with typed inputs; its response is checked against the schema)

Resolves a blockchain address to the vault account that owns it. Returns the vault account ID and the blockchains associated with the address.
**Note:** This endpoint is currently in beta and might be subject to changes.

## Query parameters

- `address` string, required

## Response `200`

Vault account that owns the address, with associated blockchains.

- AddressReverseLookupResponse: Reverse-lookup result mapping a blockchain address to its owning vault account.
  - `address` string, required: The queried blockchain address.
  - `type` 'VAULT_ACCOUNT', required: Source type of the resolved address.
  - `vaultAccountId` string, required: Vault account ID that owns the address.
  - `blockchains` string[], required: Blockchain assets associated with this address in the vault account.

## Other responses

- `401`: Unauthorized. Missing / invalid JWT token in Authorization header.
- `403`: Feature is not enabled for the workspace.
- `404`: Vault account not found for the supplied address
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)