# Get Locations

Get all locations for the company.

Endpoint: GET /v1/locations
Security: OAuth2

## Query parameters:

  - `cursor` (string)
    Pagination cursor for fetching the next page of results.
Omit or pass an empty string to start from the beginning of the list.

  - `limit` (integer)
    Maximum number of items to return per page.
Defaults to 100, maximum 100.

## Response 200 fields (application/json):

  - `next` (string)
    Cursor for the next page of results.
An empty string or absent value indicates the end of the list.

  - `items` (array)
    The list of locations on the current page.

  - `items.id` (string, required)
    The unique identifier of the location.

  - `items.timezone` (string, required)
    The IANA time zone that interprets the offset-free start_time and end_time on the location's sessions.
Falls back to Europe/Copenhagen when the company has not set one.
    Example: "Europe/Copenhagen"

  - `items.address` (object, required)
    The postal address of the location.

  - `items.address.address_lines` (array)
    Address lines.
The first line is the primary address line, e.g. street name and number.
The second line is the secondary address line, e.g. apartment number.

  - `items.address.city` (string)
    The city of the location.

  - `items.address.zip_code` (string)
    The postal code of the location.

  - `items.address.region` (string)
    The region of the location.
This can be a state, province, or other administrative region.

  - `items.address.country` (string)
    The country of the location.

  - `items.created_at` (string, required)
    Timestamp of when the location was created.

  - `items.updated_at` (string, required)
    Timestamp of the most recent change to this location.

  - `items.coordinates` (object)
    The geographic coordinates of the location.
Omitted unless both a latitude and a longitude are known.

  - `items.coordinates.latitude` (number, required)
    The latitude of the point, in decimal degrees.
    Example: 56.1577

  - `items.coordinates.longitude` (number, required)
    The longitude of the point, in decimal degrees.
    Example: 10.20652

## Response 400 fields (application/json):

  - `message` (string, required)

  - `code` (string, required)