Skip to main content
GET
/
api
/
v1
/
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": null,
    "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.
Requires the LOCATIONS_VIEW or TEST_SESSIONS_SCHEDULE scope. Requests made with a key that lacks both scopes return 403 Forbidden.

​
Request

This endpoint takes no request parameters.

​
Response

On success, the API returns 200 OK with an array of location objects.
​
id
string
required
Unique location identifier (UUID).
​
name
string
required
Display name of the location.
​
company_name
string
Company or clinic name. May be null.
​
address_line_1
string
Street address line 1. May be null.
​
address_line_2
string
Street address line 2. May be null.
​
city
string
City. May be null.
​
state
string
State or province. May be null.
​
postal_code
string
Postal or ZIP code. May be null.
​
country_name
string
Full country name. May be null.
​
country_code
string
ISO 3166-1 alpha-2 country code (e.g., DE, US, FI). May be null.
​
timezone
string
IANA timezone identifier (e.g., Europe/Berlin). May be null.
​
contact_phone
string
Contact phone number for the location. May be null.
​
email
string
Contact email address. May be null.
​
website
string
Website URL. May be null.
​
google_maps_url
string
Google Maps link for the location. May be null.
​
image_url
string
URL of a location photo. May be null.
​
open_hours
object
Weekly opening hours for the location. Structure varies by location. May be null.

​
Error responses

StatusDescription
403Forbidden — missing LOCATIONS_VIEW or TEST_SESSIONS_SCHEDULE scope.
500Internal 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": null,
    "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": []
    }
  }
]