---
title: "Get address ownership information"
method: GET
path: "/v1/addresses/address-ownerships/{address}"
tags: ["Address Book"]
---

# Get address ownership information

`GET /v1/addresses/address-ownerships/{address}`

## Request

- Base URL: `https://api.eu1.notabene.id`
- URL: `https://api.eu1.notabene.id/v1/addresses/address-ownerships/{address}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/notabene/apis/notabene-api/docs/v1/addresses/address-ownerships/:address/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the ownership information about a customer blockchain address.

## Path parameters

- `address` string, required: Blockchain address

## Query parameters

- `vasp_did` string, required: Decentralized Identifier
- `asset` string, required: Crypto currency

## Response `200`

Address Ownership Information

- AddressOwnershipResponse
  - `owner_vasp_did` string
  - `owner_vasp_name` string
  - `address` string: Blockchain address
  - `address_type` 'HOSTED' | 'UNHOSTED'
  - `asset` string: Crypto currency
  - `source` 'UNKNOWN' | 'ADDRESS_HASH' | 'ADDRESS_GRAPH' | 'CHAINALYSIS' | 'ELLIPTIC': Source of address information * `UNKNOWN` Address is not kwown. * `ADDRESS_HASH` Notabene private address network. * `ADDRESS_GRAPH` Notabene address graph. * `CHAINALYSIS` Chainalysis * `ELLIPTIC` Elliptic * `CRYSTAL` Crystal

## Other responses

- `404`: Address Ownership Information Not Found

---

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