---
title: "List addresses"
method: GET
path: "/api/link/v1/enterprises/{enterpriseId}/addresses"
tags: ["Link Addresses"]
---

# List addresses

`GET /api/link/v1/enterprises/{enterpriseId}/addresses`

Returns a paginated list of addresses for the enterprise. Results are
scoped to the caller's `link.account.view` permission. Supports filtering
by accountIds, type, status, asset, and network.

## Path parameters

- `enterpriseId` string, required

## Query parameters

- `limit` union, required
  - string
  - 50
- `offset` union, required
  - string
  - 0
- `accountIds` string[]
- `type` 'deposit' | 'withdrawal'
- `status` 'active' | 'inactive'
- `asset` string
- `genericAsset` string
- `network` string
- `sortBy` 'createdDate', required
- `orderDirection` 'asc' | 'desc', required

## Headers

- `user-id` string, required

## Response `200`

OK

- V1GetAddressesResponse
  - `addresses` object[], required
    - `id` string, required
    - `accountId` string, required
    - `name` string, required
    - `type` 'deposit' | 'withdrawal', required
    - `status` 'active' | 'inactive', required
    - `address` string, required
    - `asset` string
    - `genericAsset` string
    - `network` string, required
    - `tag` string
    - `createdDate` string, date-time, required
    - `modifiedDate` string, date-time, required
  - `total` number, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

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