---
title: "List tenant locations with pagination"
method: GET
path: "/locations"
tags: ["Locations"]
---

# List tenant locations with pagination

`GET /locations`

Returns a paginated list of location records scoped to the tenant identified by the required `tenant-id` header.

**When to use:** Use this operation to browse or enumerate locations for a tenant. For a single known location use `GET /locations/{id}` instead.

**Preconditions:** The `tenant-id` header is required; omitting it will result in a 400. Pagination is offset-based: supply `page` (0-based, defaults to 0) and `size` (items per page, defaults to 2 — this default is applied consistently across every OperationalValue list endpoint on the platform). No filter query parameters are currently exposed beyond page/size.

## Query parameters

- `page` integer
- `size` integer

## Headers

- `tenant-id` string

## Response `200`

A paginated envelope (PagedResponse) containing a `data` array of location objects and a `totalCount` field. The array may be empty if no locations exist for the tenant.

- PagedResponse
  - `data` unknown[] — The page of results for this request.
    - unknown
  - `totalCount` integer — Total number of records matching the request, across all pages.
  - `identifiersSearched` integer — Count of identifiers submitted for a bulk-identifier search (e.g. bulk NPI search). Omitted/null for standard (non-bulk) list requests.
  - `matchedCount` integer — Count of submitted identifiers that matched a record. Omitted/null for standard (non-bulk) list requests.
  - `notFoundCount` integer — Count of submitted identifiers that did not match any record. Omitted/null for standard (non-bulk) list requests.
  - `unmatchedIdentifiers` string[] — Submitted identifiers that did not match any record. Omitted/null for standard (non-bulk) list requests.

## Other responses

- `400` — Invalid input parameters, or missing `tenant-id` header.

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)