---
title: "Fetch location info via cursor ids."
method: GET
path: "/api/v4/locations-by-ids"
tags: ["Locations"]
---

# Fetch location info via cursor ids.

`GET /api/v4/locations-by-ids`

Returns full location information for a specified set of location IDs in one request.

## Query parameters

- `locationIds` string, required — JSON-encoded filter object

## Response `200`

Successful response

- LocationSummaryType[]
  - `id` string, required
  - `databaseId` integer
  - `storeId` string
  - `name` string, required
  - `street` string
  - `city` string
  - `stateIso` string
  - `countryIso` string
  - `postalCode` string
  - `latitude` number, float
  - `longitude` number, float
  - `phone` string
  - `website` string
  - `status` 'ACTIVE' | 'ARCHIVED' | 'PENDING' | 'TEMPORARILY_CLOSED' | 'SCHEDULED_FOR_ARCHIVE' — Lifecycle states of a location.
  - `primaryGbpSiteCategoryId` string
  - `additionalGbpSiteCategoryIds` string[]
  - `serviceArea` ServiceAreaType[]
    - `businessType` string
    - `regionCode` string
    - `placeInfos` PlaceInfoType[]
      - `placeId` string, required
      - `placeName` string
  - `placeActionLinks` PlaceActionLinkType[]
    - `placeActionType` string, required
    - `uri` string, required
    - `isPreferred` boolean
    - `name` string
    - `providerType` string
    - `isEditable` boolean
    - `submissionStatus` string
    - `submissionMessage` string
    - `submissionCode` string
    - `lastSubmittedAt` string
  - `discoveredPlaceActionLinks` PlaceActionLinkType[]
    - `placeActionType` string, required
    - `uri` string, required
    - `isPreferred` boolean
    - `name` string
    - `providerType` string
    - `isEditable` boolean
    - `submissionStatus` string
    - `submissionMessage` string
    - `submissionCode` string
    - `lastSubmittedAt` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Server error

## Changes

> 4 revisions in range; 1 could not be searched.

- **2026-07-31** `9274a1eac380` — 1 breaking, 1 warning
  - added the new required `query` request parameter `locationIds`
  - deleted the `query` request parameter `ids`
- **2026-07-26** `f41a4d1dfdb8` — 1 breaking, 1 warning
  - added the new required `query` request parameter `ids`
  - deleted the `query` request parameter `locationIds`

[Change history](https://skmtc.dev/listingsapi/apis/listings-api/changes/api/v4/locations-by-ids/get.md)

---

[API](https://skmtc.dev/listingsapi/apis/listings-api.md) · [All operations](https://skmtc.dev/listingsapi/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/listingsapi/listings-api/revisions/2d0f7a88fc45/schema)