---
title: "List job locations"
method: GET
path: "/api/v1/hris/org/locations"
tags: ["Locations", "Public API"]
---

# List job locations

`GET /api/v1/hris/org/locations`

Retrieves a paginated list of job locations. Returns active locations by default. Supports pagination via page and pageSize query parameters.

OAuth Scopes: field

## Query parameters

- `pageSize` integer
- `page` integer
- `sort` string
- `select` string
- `filter` string
- `expand` string[]

## Response `200`

A paginated list of job locations

- object — A response object that contains a paginated list of results.
  - `data` object[] — Array of location resources for the current page
    - `id` string — Unique identifier for the location
    - `label` string — Display name for the location
    - `archived` boolean — Whether the location is archived
    - `manageable` boolean — Whether the location is manageable
    - `address` object — Address information for the location
      - `address1` string, nullable — Address line 1. Should only be null if this is a remote location
      - `address2` string, nullable — Address line 2
      - `city` string, nullable — City name. Should only be null if this is a remote location
      - `stateId` string, nullable — State identifier. Should only be null if this is a remote location
      - `state` object — State information. Optional and requested via expand property from the request
        - `id` string — State identifier
        - `name` string — State name
        - `abbreviation` string — State abbreviation
      - `zipcode` string, nullable — Postal code. Should only be null if this is a remote location
      - `countryId` string, nullable — Country identifier. Should only be null if this is a remote location
      - `country` object — Country information. Optional and requested via expand property from the request
        - `id` string — Country identifier
        - `name` string — Country name
        - `isoCode` string — Country ISO code
      - `timezone` string, nullable — Timezone name
      - `remoteLocation` boolean — Whether this is a remote location
    - `createdAt` string, date-time, nullable — ISO 8601 timestamp of when the location was created
    - `archivedAt` string, date-time, nullable — ISO 8601 timestamp of when the location was archived
  - `meta` PaginationMetaData — A response object that contains pagination metadata.
    - `page` integer — The page number of the results.
    - `pageSize` integer — The number of items per page.
    - `totalPages` integer — The total number of pages available.
    - `totalItems` integer — The total number of items available.
  - `_links` object, nullable — Hypermedia links for collection navigation (next, prev) and available collection actions (e.g., create). Actions are permission-based and may vary.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Invalid input.
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)