Skip to main content
A location is a physical test center where blood draws are performed by healthcare professionals. You use a location’s id to schedule practitioner appointments.
Your API key only returns locations within your partner access context. Use GET /api/v1/locations to list all locations available to you.

​
Fields

​
id
string
required
UUID for the location. Pass this as location_id when creating an appointment.
​
name
string
required
Display name for the location.
​
company_name
string
Clinic or company operating the location. May be null.
​
address_line_1
string
Primary street address. May be null.
​
address_line_2
string
Secondary address line (suite, floor, etc.). May be null.
​
city
string
City. May be null.
​
state
string
State or province (resolved via the city’s linked state). May be null when the city has no linked state.
​
postal_code
string
Postal or ZIP code. May be null.
​
country_name
string
Full country name (e.g., Germany). May be null.
​
country_code
string
Two-letter country code per ISO 3166-1 alpha-2 (e.g., DE, US). May be null.
​
timezone
string
IANA timezone identifier for the location (e.g., Europe/Berlin, America/New_York). Use this to display scheduled times in the correct local time. May be null.
​
contact_phone
string
Phone number for the location. May be null.
​
email
string
Email address for the location. May be null.
​
website
string
Website URL for the location. May be null.
​
google_maps_url
string
Direct link to the location on Google Maps. May be null.
​
image_url
string
URL of a photo of the location. May be null.
​
open_hours
object
Weekly opening hours for the location. Each weekday key (monday–sunday) maps to an array of { open, close } time ranges in HH:MM (24h) format. An empty array means the location is closed that day. May be null if hours are not available for the location.
Always use the timezone field to convert scheduled_at datetimes into local time before displaying them to patients or staff.

​
Availability

The open_hours field above describes the static weekly opening schedule. To render real bookable slots — and avoid double-booking against existing Aniva sessions — call Get Availability for the location and pass it the date window you want to display. That endpoint surfaces live slot starts (combining the location’s upstream scheduling provider with subtraction of already-booked sessions) and is the right source of truth for any booking UI.

​
Example location

{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "name": "Mitte Health Center",
  "company_name": "Aniva Berlin GmbH",
  "address_line_1": "Friedrichstraße 100",
  "address_line_2": null,
  "city": "Berlin",
  "state": "Berlin",
  "postal_code": "10117",
  "country_name": "Germany",
  "country_code": "DE",
  "timezone": "Europe/Berlin",
  "contact_phone": "+493012345678",
  "email": "berlin@anivahealth.com",
  "website": "https://anivahealth.com",
  "google_maps_url": "https://maps.google.com/?q=Friedrichstra%C3%9Fe+100+Berlin",
  "image_url": "https://anivahealth.com/images/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": []
  }
}