---
title: "Get Metrc locations"
method: GET
path: "/public/v1/metrc/locations"
tags: ["Metrc"]
---

# Get Metrc locations

`GET /public/v1/metrc/locations`

## Request

- Base URL: `https://app.distru.com`
- URL: `https://app.distru.com/public/v1/metrc/locations`
- Auth: HTTP bearer

Get the Metrc locations — the room/location definitions Distru caches from Metrc — across your licenses, filtered by various attributes. Results are ordered by Metrc's location id ascending and scoped to the company that owns the API key.

Each row mirrors a location as it exists in Metrc (name, location type, and which entity kinds it may hold), plus the owning `license`. Locations deleted in Metrc are included by default — use `is_deleted` to return only live or only deleted locations.

This is a read-only cache: it does not create, edit, or delete locations in Metrc. Data is eventually consistent — changes synced from Metrc can take up to ~1 second to appear here.

## Query parameters

- `license_id` string
- `license_number` string
- `search` string
- `is_deleted` boolean
- `ids` integer[]
- `fetched_datetime` string
- `page` string

## Response `200`

A list of Metrc locations

- MetrcLocations: A collection of Metrc locations. Note: This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.
  - `data` MetrcLocation[]: Metrc Locations
    - `fetched_datetime` string, required: The datetime Distru last fetched this location from Metrc
    - `for_harvests` boolean, required: True when Metrc allows harvests in this location
    - `for_packages` boolean, required: True when Metrc allows packages in this location
    - `for_plant_batches` boolean, required: True when Metrc allows plant batches in this location
    - `for_plants` boolean, required: True when Metrc allows plants in this location
    - `id` integer, required: The location's identifier in Metrc. A Metrc identifier, not a Distru ID.
    - `is_deleted` boolean, required: True when the location has been deleted in Metrc.
    - `license` License, required: A cannabis license held by a company or tied to a location, identifying it to the state and its compliance system.
      - `active` boolean, required: Whether this license is currently active
      - `expiry_datetime` string, required: ISO 8601 datetime this license expires (e.g. "2026-08-20T00:00:00Z")
      - `id` string, required: ID for this license
      - `inserted_datetime` string, required: ISO 8601 datetime this license was created at
      - `issue_datetime` string: ISO 8601 datetime this license was issued, or null when not set
      - `license_number` string, required: License number
      - `license_type` string, required: The license type as configured in Distru. A state-specific free-form value, e.g. "Distributor" or "Type 11 Distributor-Transport"
    - `location_type_name` string, required: The Metrc location type name (e.g. "Default Location Type")
    - `name` string, required: The location name as reported by Metrc
  - `next_page` string: URL for the next page of results; null when there is no next page

## Other responses

- `400`: Invalid parameters
- `401`: Missing or invalid API token
- `403`: The API token lacks the required permission, or team restrictions hide the record

## Changes

- **2026-09-04** `f8930b2c2924`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/distru/apis/distru-api/changes/public/v1/metrc/locations/get.md)

---

[API](https://skmtc.dev/distru/apis/distru-api.md) - [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) - [OpenAPI document](https://skmtc.dev/distru/apis/distru-api/revisions/9d851a88e82f?raw)