---
title: "Lookup a Location"
method: GET
path: "/data/entities/locations/{entity_id}"
tags: ["Entity"]
---

# Lookup a Location

`GET /data/entities/locations/{entity_id}`

## Path parameters

- `entity_id` string, required

## Query parameters

- `field_ids` LocationFieldId[]
- `card_ids` string[]

## Response `200`

Single Location result

- LocationEntity
  - `cards` object
    - `fields` Location
      - `country_code` string — Short alphabetic or numeric geographical codes that represent countries (e.g. TWN, USA, ZAF)
      - `country_code_ext` string
      - `created_at` string, date-time — Created At
      - `entity_def_id` 'location' — * location - Location
      - `facet_ids` string[] — Type of location (e.g. City, Continent, Regional Area)
      - `groups` LocationIdentifier[] — Regional areas this location belongs to (e.g. San Francisco Bay Area, Silicon Valley)
        - `entity_def_id` string, required — What type of entity this be
        - `image_id` string — Optionally provided location to obtain an image representing this entity
        - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
        - `permalink` string — Optionally provided within Entity Def unique nice id of this entity
        - `uuid` string, uuid, required — Globally unique id of this entity
        - `value` string — Textual representation of this entity (i.e. its "name")
      - `identifier` LocationIdentifier, required — Every location entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` string, required — What type of entity this be
        - `image_id` string — Optionally provided location to obtain an image representing this entity
        - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
        - `permalink` string — Optionally provided within Entity Def unique nice id of this entity
        - `uuid` string, uuid, required — Globally unique id of this entity
        - `value` string — Textual representation of this entity (i.e. its "name")
      - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group' — Type of location (e.g. City, Continent, Regional Area) * city - City * continent - Continent * country - Country * group - Regional Area * region - Region
      - `locations` LocationIdentifier[] — Full location name (e.g. Denver, Colorado, United States, North America)
        - `entity_def_id` string, required — What type of entity this be
        - `image_id` string — Optionally provided location to obtain an image representing this entity
        - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
        - `permalink` string — Optionally provided within Entity Def unique nice id of this entity
        - `uuid` string, uuid, required — Globally unique id of this entity
        - `value` string — Textual representation of this entity (i.e. its "name")
      - `name` string
      - `permalink` string
      - `permalink_aliases` string[] — These are the alternative aliases to the primary permalink of the Organization
      - `region_code` string — Region code used to define location
      - `short_description` string — Description
      - `updated_at` string, date-time — Updated At
      - `uuid` string, uuid
  - `properties` Location
    - `country_code` string — Short alphabetic or numeric geographical codes that represent countries (e.g. TWN, USA, ZAF)
    - `country_code_ext` string
    - `created_at` string, date-time — Created At
    - `entity_def_id` 'location' — * location - Location
    - `facet_ids` string[] — Type of location (e.g. City, Continent, Regional Area)
    - `groups` LocationIdentifier[] — Regional areas this location belongs to (e.g. San Francisco Bay Area, Silicon Valley)
      - `entity_def_id` string, required — What type of entity this be
      - `image_id` string — Optionally provided location to obtain an image representing this entity
      - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
      - `permalink` string — Optionally provided within Entity Def unique nice id of this entity
      - `uuid` string, uuid, required — Globally unique id of this entity
      - `value` string — Textual representation of this entity (i.e. its "name")
    - `identifier` LocationIdentifier, required — Every location entity in the system has a unique identifier that contains all necessary properties to represent it.
      - `entity_def_id` string, required — What type of entity this be
      - `image_id` string — Optionally provided location to obtain an image representing this entity
      - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
      - `permalink` string — Optionally provided within Entity Def unique nice id of this entity
      - `uuid` string, uuid, required — Globally unique id of this entity
      - `value` string — Textual representation of this entity (i.e. its "name")
    - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group' — Type of location (e.g. City, Continent, Regional Area) * city - City * continent - Continent * country - Country * group - Regional Area * region - Region
    - `locations` LocationIdentifier[] — Full location name (e.g. Denver, Colorado, United States, North America)
      - `entity_def_id` string, required — What type of entity this be
      - `image_id` string — Optionally provided location to obtain an image representing this entity
      - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
      - `permalink` string — Optionally provided within Entity Def unique nice id of this entity
      - `uuid` string, uuid, required — Globally unique id of this entity
      - `value` string — Textual representation of this entity (i.e. its "name")
    - `name` string
    - `permalink` string
    - `permalink_aliases` string[] — These are the alternative aliases to the primary permalink of the Organization
    - `region_code` string — Region code used to define location
    - `short_description` string — Description
    - `updated_at` string, date-time — Updated At
    - `uuid` string, uuid

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Request Failed

---

[API](https://skmtc.net/crunchbase/apis/firmographic-package.md) · [All operations](https://skmtc.net/crunchbase/apis/firmographic-package/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchbase/firmographic-package/versions/3277c0d3e46a/schema)
