---
title: "List Available Pickup Slots"
method: GET
path: "/2024-09/courier_services/{courier_service_id}/pickup_slots"
tags: ["Courier Services"]
---

# List Available Pickup Slots

`GET /2024-09/courier_services/{courier_service_id}/pickup_slots`

## Request

- Base URL: `https://public-api.easyship.com`
- URL: `https://public-api.easyship.com/2024-09/courier_services/{courier_service_id}/pickup_slots`
- Auth: HTTP bearer

Retrieve a list of pickup slots in local time for the coming seven days.

Required authorization scope: `public.pickup:read`

## Path parameters

- `courier_service_id` string, required

## Query parameters

- `origin_address_id` string

## Response `200`

available pickup slots

- PickupSlotList: List of Pickup Slots
  - `courier_service_handover_option` object
    - `provider_name` string
    - `pickup_slots` PickupSlot[]
      - `date` string, date
      - `time_slots` object[]
        - `time_slot_id` string, uuid
        - `from_time` string
        - `to_time` string
  - `meta` Meta
    - `request_id` string: An unique ID represent the request.

## Other responses

- `400`: failed validations
- `404`: pickup not supported by courier service

---

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