---
title: "List pickup points by location"
method: GET
path: "/api/checkout/pub/pickup-points"
tags: ["Fulfillment"]
---

# List pickup points by location

`GET /api/checkout/pub/pickup-points`

Retrieves information on pickup points close to a given location determined by geocoordinates or postal code.


The pickup points returned are not necessarily all active ones. Make sure to validate the information consumed by integrations.

## Permissions

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

## Query parameters

- `geoCoordinates` string — Geocoordinate.
- `postalCode` string
- `countryCode` string
- `individualShippingEstimates` boolean

## Headers

- `Content-Type` string, required
- `Accept` string, required

## Response `200`

OK

- object
  - `paging` object — Paging.
    - `page` integer — Page number.
    - `pageSize` integer — Page size.
    - `total` integer — Total pages.
    - `pages` integer — Pages.
  - `items` object[] — Items.
    - `distance` number — Distance.
    - `pickupPoint` object — Pickup point.
      - `friendlyName` string — Friendly name.
      - `address` object — Address.
        - `addressType` string — Address type.
        - `receiverName` string — Receiver name.
        - `addressId` string, nullable — Address ID.
        - `isDisposable` boolean — Indicates whether the address is disposable. Addresses marked as `isDisposable = true` are not saved to the shopper's profile when the order is completed, while addresses with `isDisposable = false` definitely belong to the shopper. Behavior by address type: - `giftRegistry`, `pickup`, `search`, and `inStore`: always disposable, as they do not belong to the shopper navigating the cart. - `residential`: may be disposable. Addresses from a complete shopper profile, or entered by an authenticated shopper with a complete profile, are not disposable. All other residential addresses are disposable, including those from first-time purchases, since no complete profile exists yet. - `invoice`: does not have the `isDisposable` flag, since invoice addresses are of type `Address` rather than `ShippingAddress`. In practice, only authenticated shoppers can add invoice attachments to the cart, so they are never treated as disposable. - `commercial`: corresponds to company addresses used in B2B contexts and follows the same logic as residential addresses. When a residential address is marked as disposable and the profile is complete, authentication is required to complete the order. Additionally, when a disposable residential address is used to complete a purchase, saved cards cannot be used.
        - `postalCode` string — Postal code.
        - `city` string — City.
        - `state` string — State.
        - `country` string — Country.
        - `street` string — Street.
        - `number` string — Number.
        - `neighborhood` string — Neighborhood.
        - `complement` string, nullable — Complement to the shipping address, in case it applies.
        - `reference` string — Racao.
        - `geoCoordinates` integer[] — Geo coordinates.
      - `additionalInfo` string — Additional info.
      - `id` string — ID.
      - `businessHours` object[] — Array with business hours.
        - `DayOfWeek` integer — Day of week.
        - `OpeningTime` string — Opening time.
        - `ClosingTime` string — Closing time.

---

[API](https://skmtc.net/vtex/apis/checkout-api.md) · [All operations](https://skmtc.net/vtex/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vtex/checkout-api/revisions/fc777477b318/schema)