---
title: "Lookup places"
method: POST
path: "/v4/track/place-info/lookup/"
tags: ["Place Info"]
---

# Lookup places

`POST /v4/track/place-info/lookup/`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

Lookup drop-off/pick-up locations for a courier, by location & distance.

## Query parameters

- `account` integer[]
- `ordering` string

## Request body

- PlaceInfoLookupRequestRequest: Place info lookup request. Either 'location' or 'external_reference' must be provided (mutually non-exclusive).
  - `account` integer, required: ID of account for this lookup
  - `location` GeoLocation
    - `type` 'Point'
    - `latitude` number, required: Latitude of this location
    - `longitude` number, required: Longitude of this location
    - `postal_code` string: Postal code of this location
    - `region_code` string: Region code, e.g. state or province code (ISO 3166-2), if available
    - `city` string: City name (min-length of 1 due to logographic languages)
    - `country_iso3` string: ISO 3166-1 alpha-3 code of country
  - `external_reference` string, nullable
  - `lookups` PlaceInfoLookupItem[], required: List of lookups (courier, service level, criteria) to execute
    - `courier` string, required: Courier code, e.g. 'fedex', 'dhl'
    - `service_level` string: Service level to filter locations by
    - `criteria` PlaceSearchFilter[]: Criteria for the lookup, e.g. is delivery location (hold-at)
    - `max_distance` number: Maximum distance to search for locations
    - `unit` 'km' | 'mi'
    - `limit` integer: Maximum number of results to return
  - `country_iso3` string, required: ISO 3166-1 alpha-3 code of country
  - `location_address` union: Optional address components to supplement coordinate lookups. A partial address is accepted; required components depend on the courier.
    - AddressSchema
      - `first_name` string
      - `last_name` string
      - `company_name` string
      - `address_line` string, required: Address line, e.g. street and house number, or PO Box
      - `address_line_extra` string: Additional address line, e.g. apartment number or company name
      - `postal_code` string, required
      - `city` string, required: City name (min-length of 1 due to logographic languages)
      - `country_iso3` string, required: ISO 3166-1 alpha-3 code of country
      - `region_code` string: Region code, e.g. state or province code (ISO 3166-2), if available
      - `phone` string: Phone number related to this address, if any
    - PlaceInfoLookupAddress: Address components used to supplement a coordinate lookup.
      - `address_line` string
      - `postal_code` string
      - `city` string
      - `country_iso3` string, required
      - `region_code` string

## Response `200`

- PlaceInfoLookupResponseItem[]
  - `location_address` AddressSchema, required
    - `first_name` string
    - `last_name` string
    - `company_name` string
    - `address_line` string, required: Address line, e.g. street and house number, or PO Box
    - `address_line_extra` string: Additional address line, e.g. apartment number or company name
    - `postal_code` string, required
    - `city` string, required: City name (min-length of 1 due to logographic languages)
    - `country_iso3` string, required: ISO 3166-1 alpha-3 code of country
    - `region_code` string: Region code, e.g. state or province code (ISO 3166-2), if available
    - `phone` string: Phone number related to this address, if any
  - `location` GeoLocation, required
    - `type` 'Point'
    - `latitude` number, required: Latitude of this location
    - `longitude` number, required: Longitude of this location
    - `postal_code` string: Postal code of this location
    - `region_code` string: Region code, e.g. state or province code (ISO 3166-2), if available
    - `city` string: City name (min-length of 1 due to logographic languages)
    - `country_iso3` string: ISO 3166-1 alpha-3 code of country
  - `opening_hours` OpeningHourItem[], required: Opening hours of this place
    - `day` 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' | 'sun', required
    - `open` string, time, required: Opening time (HH:MM)
    - `close` string, time, required: Closing time (HH:MM)
  - `raw_place_type` string
  - `distance` number, double, nullable, required: Distance to the place
  - `courier` string, required
  - `country_iso3` string, required: ISO 3166-1 alpha-3 code of the country
  - `place_type` 'default' | 'self_service' | 'partner_location' | 'store' | 'other': * `default` - Default (first party) * `self_service` - Self-Service / Locker * `partner_location` - Partner Location * `store` - Store * `other` - Other (e.g. hub)
  - `name` string, required: Name of this place
  - `phone_number` string
  - `website` union
    - string, uri
    - string
  - `criteria` string[]: Search Criteria that this place matches
  - `services` ServicesEnum[]: Services provided at this place
  - `raw_services` string[]: Raw (carrier-provided) services provided at this place
  - `has_details` boolean: Whether this place info includes place details
  - `is_in_service` boolean: Whether this place is in service (open)
  - `external_reference` string: External (3rd party) reference of this place, e.g. unique location ID
  - `external_id` string, uuid: parcelLab generated unique ID for this place
  - `additional_info` object: Additional information about this place

## Other responses

- `400`
- `403`
- `404`

## Changes

- **2026-11-03** `84524f38b6c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/parcellab/apis/parcellab-api/changes/v4/track/place-info/lookup/post.md)

---

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