# List pickup slots

`GET /client_api/v2/orders/{order_id}/pickup_availabilities`

The days and times the carrier can collect the order. Pick a slot from here before you book a pickup.

## Parameters

- `order_id` (integer, required): The order's id. Get it from List orders (`GET /client_api/v2/orders`): send the `id` of the one you want. Ids differ between the sandbox and production.

## Returns

Returns a list.

- `earliest_pickup_time` (string, required): The earliest the goods can be ready, as `HH:MM`.
- `latest_pickup_end_time` (string, required): The latest the collection point can close, as `HH:MM`.
- `latest_pickup_start_time` (string, required): The latest the goods can be ready, as `HH:MM`.
- `minimum_access_duration_minutes` (integer, required): How long, at least, the driver needs between ready time and closing time.
- `pickup_date` (string, required): A day the carrier can collect, as `YYYY-MM-DD`.
- `time_zone_id` (object, nullable, required): The time zone the times are in. Usually empty, in which case they are local to the collection address.

## Errors

- `401 Unauthorized`: The token is missing, expired or invalid. Sign in again.

## Example request (curl)

```bash
curl -X GET "https://sandbox-api.vatit-stream.com/client_api/v2/orders/1/pickup_availabilities" \
  -H "Authorization: Bearer $API_TOKEN"
```

## Example response (200)

```json
[
  {
    "earliest_pickup_time": "09:00",
    "latest_pickup_end_time": "16:30",
    "latest_pickup_start_time": "15:00",
    "minimum_access_duration_minutes": 90,
    "pickup_date": "2026-10-26",
    "time_zone_id": null
  }
]
```
