> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Location

> Retrieve one test location by its ID

Retrieve one location. It has the same shape as an entry of
[List Locations](/api/locations/list-locations). The `url` of a `location.*`
[webhook](/concepts/webhooks) event points here.

Requires the `locations_view` or `test_sessions_schedule` scope.

## Request

### Path parameters

**id** `string` *required*

Location ID (UUID).

## Response

On success, the API returns `200 OK` with the location object.

**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`.

**street** `string`

Street name, without the house number. May be `null`.

**house\_number** `string`

House number. May be `null`.

**address\_line\_2** `string`

Additional address line — c/o, building, or floor. May be `null`.

**city** `string`

City. May be `null`.

**state** `string`

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

**state\_code** `string`

The state's ISO 3166-2 code without the country prefix (e.g., `BW` for Baden-Württemberg). 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`.

**latitude** `number`

Latitude of the address in decimal degrees (WGS 84). May be `null`.

**longitude** `number`

Longitude of the address in decimal degrees (WGS 84). 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. 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.

**per-day time range**

**open** `string` *required*

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

**close** `string` *required*

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

## Error responses

| Status | Description |
| - | - |
| `400` | The `id` is not a UUID. |
| `401` | The API key is missing or invalid. |
| `403` | Your API key does not have the required scope. |
| `404` | The location does not exist, is inactive, or is outside your access. |
| `500` | Internal server error. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/locations/b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "name": "Aniva Berlin Mitte",
  "company_name": "Aniva GmbH",
  "street": "Unter den Linden",
  "house_number": "42",
  "address_line_2": null,
  "city": "Berlin",
  "state": "Berlin",
  "state_code": "BE",
  "postal_code": "10117",
  "country_name": "Germany",
  "country_code": "DE",
  "timezone": "Europe/Berlin",
  "latitude": 52.517036,
  "longitude": 13.388859,
  "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": []
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.