---
title: "Gets multiple locations"
method: GET
path: "/locations"
tags: ["Location"]
---

# Gets multiple locations

`GET /locations`

## Request

- Base URL: `https://eliq.data-management-api.eliq.com` (the document declares no server; this is the origin it was published from)
- URL: `https://eliq.data-management-api.eliq.com/locations`
- Auth: none declared
- TypeScript: <https://skmtc.dev/eliq/apis/eliq-data-management-api/docs/locations/get.ts> (a function with typed inputs; its response is checked against the schema)

Locations are fetched in batches of maximum 1000 locations, and returned in created date order.
Using parameters after_id and limit can be used to iterate over the full location base.
Parameter created_after can also be used to fetch locations after a certain date.

## Query parameters

- `after_id` string
- `limit` integer
- `created_after` string

## Response `200`

OK

- Location[]
  - `id` string, nullable
  - `eliq_id` integer, nullable
  - `name` string, nullable
  - `user_id` string, nullable
  - `spot_price_region_id` string, nullable
  - `address` LocationAddress
    - `street_address` string, nullable
    - `postal_code` string, nullable
    - `city` string, nullable
    - `country_code` string, nullable
  - `geo` LocationGeo
    - `latitude` number, double, nullable
    - `longitude` number, double, nullable
  - `meters` Meter[], nullable
    - `id` string, nullable
    - `eliq_id` string, nullable
    - `location_id` string, nullable
    - `name` string, nullable
    - `model` string, nullable
    - `fuel` string, nullable
    - `type` string, nullable
    - `is_sub_meter` boolean, nullable
    - `category` string, nullable
    - `category_percentage` integer, nullable
    - `supply_start_date` string, nullable
    - `supply_end_date` string, nullable
    - `created_at_timestamp` string, nullable
    - `sync_status` string, nullable
  - `created_at_timestamp` string, nullable
  - `location_profile_type` 'residential' | 'business' | 'undefined'

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/eliq/apis/eliq-data-management-api.md) - [All operations](https://skmtc.dev/eliq/apis/eliq-data-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eliq/apis/eliq-data-management-api/revisions/022af911e0d0?raw)