---
title: "List all addresses"
method: GET
path: "/ext/v2/addresses/"
tags: ["Accounts"]
---

# List all addresses

`GET /ext/v2/addresses/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/addresses/`
- Auth: HTTP bearer

Returns a list of all addresses for clinic clients (pet parents). The addresses are sorted by creation date, with the most recent addresses appearing first. When using modified filters, results are sorted in descending modification date instead.

An address represents a physical mailing or shipping location associated with a client. Addresses are used as shipping destinations for product orders and may be designated as the client's primary address.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `cursor` string, nullable: A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__gte` string, date-time, nullable: Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__lte` string, date-time, nullable: Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `is_deleted` 'FALSE' | 'TRUE' | 'ALL': When 'FALSE' (default), filters to non-deleted records only. When 'TRUE', filters to soft-deleted records only. When 'ALL', returns both deleted and non-deleted records.
- `clinic_id` integer, nullable: When provided, filters to addresses for the clinic with this ID.
- `clinic_client_id` integer, nullable: Filters to addresses for the clinic client with this ID.
- `is_active` boolean, nullable: Filter by active status. Defaults to true (only active addresses). Set to false to include only deactivated addresses, or omit to return all regardless of active status.

## Response `200`

OK

- ExternalClientAddressSchemaList
  - `data` ExternalClientAddressSchema[], required: A single page of data contained within this list.
    - `address_one` string, required: The first line of the address.
    - `address_two` string: The second line of the address.
    - `city` string, required: The city of the address.
    - `client_id` integer, required: The ID of the client that this address belongs to.
    - `clinic_id` integer, nullable, required: The ID of the clinic this address belongs to.
    - `country` 'CA' | 'US' | 'AS' | 'GU' | 'MP' | 'PR' | 'VI'
    - `county` string: The county of the address.
    - `created` string, date-time, required: The datetime this object was created.
    - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted.
    - `id` integer, required: The ID of the address.
    - `is_deleted` boolean, required: Whether this record is soft deleted or not.
    - `is_primary` boolean, required: Whether this address is the primary address of the client.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `name` string: The name of the address.
    - `phone_number` integer, nullable: The phone number of the address.
    - `state` string, required: The 2-letter code of the state/province/region of the address. Legacy data could deviate from the 2-letter code convention.
    - `zipcode` string, required: The zip code/postal code of the address.
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

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