---
title: "Retrieve Location"
method: GET
path: "/v2/company/{company_id}/locations/{location_id}"
tags: ["Locations"]
---

# Retrieve Location

`GET /v2/company/{company_id}/locations/{location_id}`

## Request

- Base URL: `https://api.7shifts.com`
- URL: `https://api.7shifts.com/v2/company/{company_id}/locations/{location_id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.7shifts.com/oauth2/authorize`
    - Client credentials
    - Password
    - Token URL: `https://app.7shifts.com/oauth2/token`
  - API key in cookie `7session`

## Path parameters

- `company_id` integer, required
- `location_id` integer, required

## Headers

- `x-api-version` string: An API version
- `x-company-guid` string, uuid

## Response `200`

OK

- object
  - `object` 'location', required
  - `data` object, required
    - `id` integer, required: Location ID
    - `company_id` integer, required: Company ID
    - `name` string, required: Location name
    - `country` string, required: Country
    - `state` string, nullable, required: State or province
    - `city` string, nullable, required: City
    - `formatted_address` string, nullable, required: Full formatted address
    - `lat` number, nullable: Latitude
    - `lng` number, nullable: Longitude
    - `place_id` string, nullable, required: Internal use
    - `timezone` string, required: Timezone. Valid zone info name
    - `timezone_updated` boolean, nullable: Internal use
    - `hash` string, required: Internal use
    - `mapping_id` string, nullable: Internal use
    - `department_based_budget` boolean, nullable, required: When true, department based budgeting is enabled
    - `holiday_pay` boolean: When true, holiday pay is enabled
    - `auto_send_log_book_time` string, nullable: Time the log book is automatically send
    - `sun_hours_close` string, required: Sunday closing time
    - `mon_hours_close` string, required: Monday closing time
    - `tue_hours_close` string, required: Tuesday closing time
    - `wed_hours_close` string, required: Wednesday closing time
    - `thu_hours_close` string, required: Thursday closing time
    - `fri_hours_close` string, required: Friday closing time
    - `sat_hours_close` string, required: Saturday closing time
    - `sun_hours_open` string, nullable, required: Sunday opening time
    - `mon_hours_open` string, nullable, required: Monday opening time
    - `tue_hours_open` string, nullable, required: Tuesday opening time
    - `wed_hours_open` string, nullable, required: Wednesday opening time
    - `thu_hours_open` string, nullable, required: Thursday opening time
    - `fri_hours_open` string, nullable, required: Friday opening time
    - `sat_hours_open` string, nullable, required: Saturday opening time
    - `sun_is_closed` boolean, nullable, required: If true, location is closed on Sunday
    - `mon_is_closed` boolean, nullable, required: If true, location is closed on Monday
    - `tue_is_closed` boolean, nullable, required: If true, location is closed on Tuesday
    - `wed_is_closed` boolean, nullable, required: If true, location is closed on Wednesday
    - `thu_is_closed` boolean, nullable, required: If true, location is closed on Thursday
    - `fri_is_closed` boolean, nullable, required: If true, location is closed on Friday
    - `sat_is_closed` boolean, nullable, required: If true, location is closed on Saturday
    - `shift_feedback` boolean, required: If true end of shift feedback requests are enabled
    - `message` string, nullable, required: Message visible to all employees
    - `deleted` boolean: If true the location is deleted
    - `created` string, date-time, required
    - `modified` string, date-time, required

## Other responses

- `403`: Forbidden
- `404`: Not found
- `500`: Server Error

---

[API](https://skmtc.dev/7shifts/apis/7shifts-api.md) - [All operations](https://skmtc.dev/7shifts/apis/7shifts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/7shifts/apis/7shifts-api/revisions/40e0ef40dfcd?raw)