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

# Lookup a Location

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

## Request

- Base URL: `https://api.crunchbase.com/v4`
- URL: `https://api.crunchbase.com/v4/data/entities/locations/{entity_id}`
- Auth: API key in header `X-cb-user-key`

## 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.dev/crunchbase/apis/insights-only-package.md) - [All operations](https://skmtc.dev/crunchbase/apis/insights-only-package/llms.txt) - [OpenAPI document](https://skmtc.dev/crunchbase/apis/insights-only-package/revisions/fe896609f5d0?raw)