List Locations

GET

api

locations

curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'

[
  {
    "id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "address_line_1": "Unter den Linden 42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": "https://maps.google.com/?q=Unter+den+Linden+42+Berlin",
    "image_url": "https://cdn.anivahealth.com/locations/berlin-mitte.jpg",
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  },
  {
    "id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c",
    "name": "Aniva Helsinki Central",
    "company_name": "Aniva Oy",
    "address_line_1": "Mannerheimintie 12",
    "address_line_2": null,
    "city": "Helsinki",
    "state": "Uusimaa",
    "postal_code": "00100",
    "country_name": "Finland",
    "country_code": "FI",
    "timezone": "Europe/Helsinki",
    "contact_phone": "+358912345678",
    "email": "helsinki@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": "https://maps.google.com/?q=Mannerheimintie+12+Helsinki",
    "image_url": "https://cdn.anivahealth.com/locations/helsinki-central.jpg",
    "open_hours": {
      "monday": [{ "open": "07:30", "close": "17:00" }],
      "tuesday": [{ "open": "07:30", "close": "17:00" }],
      "wednesday": [{ "open": "07:30", "close": "17:00" }],
      "thursday": [{ "open": "07:30", "close": "17:00" }],
      "friday": [{ "open": "07:30", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]

Retrieve all test locations accessible to your API key. Use the id from a returned location when creating an appointment with Create Appointment.

Request

This endpoint takes no request parameters.

Response

On success, the API returns 200 OK with an array of location objects.

string

required

Unique location identifier (UUID).

string

required

Display name of the location.

string

Company or clinic name. May be null.

string

Street address line 1. May be null.

string

Street address line 2. May be null.

string

City. May be null.

string

State or province. May be null when the city has no linked state (e.g. city-states or unmapped imports).

string

Postal or ZIP code. May be null.

string

Full country name. May be null.

string

ISO 3166-1 alpha-2 country code (e.g., DE, US, FI). May be null.

string

IANA timezone identifier (e.g., Europe/Berlin). May be null.

string

Contact phone number for the location. May be null.

string

Contact email address. May be null.

string

Website URL. May be null.

string

Google Maps link for the location. May be null.

string

URL of a location photo. May be null.

object

Weekly opening hours. Each weekday key (monday–sunday) maps to an array of open/close time ranges. An empty array means the location is closed that day. The whole object is null when hours are not available for the location.

Show per-day time range

string

required

Opening time in HH:MM (24h) format.

string

required

Closing time in HH:MM (24h) format.

Error responses

Status	Description
`403`	Forbidden — your API key does not have access to this operation.
`500`	Internal server error.

curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'

[
  {
    "id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "address_line_1": "Unter den Linden 42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": "https://maps.google.com/?q=Unter+den+Linden+42+Berlin",
    "image_url": "https://cdn.anivahealth.com/locations/berlin-mitte.jpg",
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  },
  {
    "id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c",
    "name": "Aniva Helsinki Central",
    "company_name": "Aniva Oy",
    "address_line_1": "Mannerheimintie 12",
    "address_line_2": null,
    "city": "Helsinki",
    "state": "Uusimaa",
    "postal_code": "00100",
    "country_name": "Finland",
    "country_code": "FI",
    "timezone": "Europe/Helsinki",
    "contact_phone": "+358912345678",
    "email": "helsinki@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": "https://maps.google.com/?q=Mannerheimintie+12+Helsinki",
    "image_url": "https://cdn.anivahealth.com/locations/helsinki-central.jpg",
    "open_hours": {
      "monday": [{ "open": "07:30", "close": "17:00" }],
      "tuesday": [{ "open": "07:30", "close": "17:00" }],
      "wednesday": [{ "open": "07:30", "close": "17:00" }],
      "thursday": [{ "open": "07:30", "close": "17:00" }],
      "friday": [{ "open": "07:30", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]

List Units

Get Availability

curl --request GET \
  --url https://anivahealth.com/api/v1/locations \
  --header 'x-api-key: YOUR_API_KEY'

[
  {
    "id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "address_line_1": "Unter den Linden 42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": "https://maps.google.com/?q=Unter+den+Linden+42+Berlin",
    "image_url": "https://cdn.anivahealth.com/locations/berlin-mitte.jpg",
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  },
  {
    "id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c",
    "name": "Aniva Helsinki Central",
    "company_name": "Aniva Oy",
    "address_line_1": "Mannerheimintie 12",
    "address_line_2": null,
    "city": "Helsinki",
    "state": "Uusimaa",
    "postal_code": "00100",
    "country_name": "Finland",
    "country_code": "FI",
    "timezone": "Europe/Helsinki",
    "contact_phone": "+358912345678",
    "email": "helsinki@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": "https://maps.google.com/?q=Mannerheimintie+12+Helsinki",
    "image_url": "https://cdn.anivahealth.com/locations/helsinki-central.jpg",
    "open_hours": {
      "monday": [{ "open": "07:30", "close": "17:00" }],
      "tuesday": [{ "open": "07:30", "close": "17:00" }],
      "wednesday": [{ "open": "07:30", "close": "17:00" }],
      "thursday": [{ "open": "07:30", "close": "17:00" }],
      "friday": [{ "open": "07:30", "close": "15:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]

Health

Profiles

Appointments

Home Kit Orders

Biomarkers

Panels

Units

Locations

Documents

Shipments

List Locations

Request

Response

Error responses

​Request

​Response

​Error responses

Request

Response

Error responses