---
title: "Get pickup point availability for Delivery Promise"
method: GET
path: "/pickup-point-availability/{facets}"
tags: ["Delivery Promise"]
---

# Get pickup point availability for Delivery Promise

`GET /pickup-point-availability/{facets}`

Retrieves the list of available pickup points with their IDs, distances, addresses, and business hours. This endpoint returns pickup points sorted by distance from the provided coordinates.

>ℹ️ Migrate to [Intelligent Search API v1](https://developers.vtex.com/docs/api-reference/intelligent-search-api-v1) for HTTP caching and lower latency. The new endpoint is: `GET` [Get pickup point availability for Delivery Promise](https://developers.vtex.com/docs/api-reference/intelligent-search-api-v1#get-/pickup-point-availability/-facets-). See the [migration guide](https://developers.vtex.com/docs/guides/migrating-to-intelligent-search-api-v1).

>⚠️ **Required facet:** Only the `tradePolicy` (trade policy/sales channel) facet is required. All product filters, including `productClusterIds`, are optional and can be provided as query parameters to narrow down the results. When no product filters are provided, all available pickup points for the trade policy will be returned.

>ℹ️ This endpoint is designed for use in [Delivery Promise for headless stores](https://developers.vtex.com/docs/guides/delivery-promise-for-headless-stores) implementations. It provides the complete list of pickup points required as a mandatory dependency for the [Delivery Promise feature](https://help.vtex.com/en/docs/tutorials/delivery-promise-beta). The system displays all available pickup points within the 50 km radius configured in Checkout when customers select pickup in the header or a specific pickup point.

You can call this endpoint in two ways:

- **With country and ZIP code:** Provide the country and ZIP code to retrieve pickup points based on location.
- **With delivery zones and pickup point hashes:** Alternatively, provide pre-computed hashes (`deliveryZonesHash` and `pickupPointsHash`) for faster lookup.

## Permissions

This endpoint does not require [authentication](https://developers.vtex.com/docs/guides/authentication) or [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).

## Path parameters

- `facets` string, nullable, required

## Query parameters

- `query` string
- `locale` string, nullable
- `pickupPoint` string
- `an` string, required
- `coordinates` string
- `zip-code` string
- `country` string
- `deliveryZonesHash` string
- `pickupPointsHash` string

## Response `200`

OK

- object — Pickup points availability response.
  - `pickupPointDistances` object[] — List of available pickup points sorted by distance.
    - `pickupId` string — Unique identifier for the pickup point.
    - `pickupName` string — Name of the pickup point.
    - `distance` number — Distance from the provided coordinates to the pickup point, in kilometers.
    - `isActive` boolean — Indicates whether the pickup point is currently active (`true`) or not (`false`).
    - `address` object — Address details of the pickup point.
      - `street` string — Street name of the pickup point address.
      - `number` string — Street number of the pickup point address.
      - `neighborhood` string — Neighborhood of the pickup point address.
      - `city` string — City of the pickup point address.
      - `state` string — State or province of the pickup point address.
      - `postalCode` string — Postal code or ZIP code of the pickup point address.
    - `businessHours` object[] — Operating hours for each day of the week.
      - `dayOfWeek` 0 | 1 | 2 | 3 | 4 | 5 | 6 — Day of the week represented as a number (0 = Sunday, 1 = Monday, 2 = Tuesday, 3 = Wednesday, 4 = Thursday, 5 = Friday, 6 = Saturday).
      - `openingTime` string — Opening time in 24-hour format with seconds (HH:MM:SS).
      - `closingTime` string — Closing time in 24-hour format with seconds (HH:MM:SS).

## Changes

- **2026-06-25** `f8abffd4079f` — 2 info
  - added the new optional `query` request parameter `locale`
  - added the new optional `query` request parameter `pickupPoint`
- **2026-06-22** `74f3bb5d579e` — 1 warning, 1 info
  - deleted the `query` request parameter `pickupsHash`
  - added the new optional `query` request parameter `pickupPointsHash`
- **2026-03-18** `1975570c37af` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/vtex/apis/intelligent-search-api-legacy/changes/pickup-point-availability/:facets/get.md)

---

[API](https://skmtc.dev/vtex/apis/intelligent-search-api-legacy.md) · [All operations](https://skmtc.dev/vtex/apis/intelligent-search-api-legacy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vtex/intelligent-search-api-legacy/revisions/62d8bce60c7e/schema)