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. May be null.
​
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. May be null if hours are not available.
Always use the timezone field to convert scheduled_at datetimes into local time before displaying them to patients or staff.

​
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": []
  }
}