---
title: "Get addresses registered"
method: GET
path: "/v1/addresses"
tags: ["Address Book"]
---

# Get addresses registered

`GET /v1/addresses`

Get the addresses registered for a VASP.

## Query parameters

- `vasp_did` string, required — Decentralized Identifier
- `source` 'ADDRESS_GRAPH', required — Blockchain address query sources available
- `source_type` 'INTERNAL' | 'EXTERNAL' — Query source types (if not provided, it will return all addresses): * `INTERNAL` - **Internal address book**: addresses owned by a VASP. It can be populated by uploading a CSV, confirming incoming transfers, registering addresses. It is used to confirm transfers. * `EXTERNAL` - **External address book**: addresses owned by counterparty VASPs. It is populated only when a counterparty VASP confirms a transfer that another VASP sent them. It is used to identify counterparty VASP via Validate / Widget / Network Discovery flows.
- `page` integer — Page number
- `per_page` integer — Records per page

## Response `200`

Addresses Registered

- AddressesResponse
  - `pagination` object
    - `page` integer — Page number
    - `per_page` integer — Records per page
    - `total` integer
  - `metadata` object
    - `source` 'ADDRESS_GRAPH' — Blockchain address query sources available
  - `data` Address[]
    - `address` string — Blockchain address
    - `owner_vasp_did` string — Custodial VASP DID
    - `customer_did` string — Customer DID
    - `customer_ref` string — Customer reference

---

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