---
title: "Showroom locations and remote consultation options"
method: GET
path: "/api/v1/showrooms"
tags: ["Content"]
---

# Showroom locations and remote consultation options

`GET /api/v1/showrooms`

## Request

- Base URL: `https://www.adadiamonds.com`
- URL: `https://www.adadiamonds.com/api/v1/showrooms`
- Auth: one of:
  - none
  - API key in header `X-Ada-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://www.adadiamonds.com/oauth/authorize`, token URL `https://www.adadiamonds.com/api/oauth/token`; client credentials, token URL `https://www.adadiamonds.com/api/oauth/token`, scopes: `content:read`)

Returns Ada's physical showroom(s) with address, hours, and phone, plus the virtual consultation details that serve shoppers everywhere else. Use it to answer whether someone outside New York can buy from Ada (yes, by video consultation) and where to book.

## Response `200`

Showrooms and virtual consultation details.

- ShowroomList
  - `object` 'list', required
  - `data` Showroom[], required
    - `name` string, required
    - `url` string, uri, required
    - `streetAddress` string, required
    - `addressLocality` string, required
    - `addressRegion` string, required
    - `postalCode` string, required
    - `addressCountry` string, required
    - `telephone` string, required
    - `hours` string, required
    - `appointmentRequired` boolean, required
  - `virtual_consultations` VirtualConsultations, required
    - `available` boolean
    - `description` string
    - `book_url` string, uri
    - `email` string, email
    - `telephone` string

## Other responses

- `429`: Over the rate limit. Wait `Retry-After` seconds; a credential raises the limit.

---

[API](https://skmtc.dev/adadiamonds/apis/ada-diamonds-agent-api.md) · [All operations](https://skmtc.dev/adadiamonds/apis/ada-diamonds-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adadiamonds/apis/ada-diamonds-agent-api/revisions/2b2ed3201815?raw)