---
title: "Retrieve available appointment timeslots for a Product."
method: GET
path: "/products/{id}/appointment_timeslots.json"
tags: ["Appointments"]
---

# Retrieve available appointment timeslots for a Product.

`GET /products/{id}/appointment_timeslots.json`

## Request

- Base URL: `https://api.jumpseller.com/v1`
- URL: `https://api.jumpseller.com/v1/products/{id}/appointment_timeslots.json`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `login` and API key in query parameter `authtoken`
  - OAuth 2
    - Authorization code: `https://accounts.jumpseller.com/oauth/authorize`
    - Token URL: `https://accounts.jumpseller.com/oauth/token` scopes: `read_products`

Returns available timeslots per date for an appointment Product, taking capacity (including shared calendars and blocked dates for weekly recurring Products), and existing bookings into account. `start_date` and `end_date` are required and dates use the store timezone; the range is limited to 31 days, matching the storefront's own appointment widget. For weekly recurring Products, timeslots are generated from the weekly schedule. For `specific_dates` Products, the merchant-configured timeslots (got as in `GET /products/{id}.json`) are returned by key of `start_date` and annotated with remaining capacity; a slot may also include `end_date`/`end_time` when it spans multiple days.

## Path parameters

- `id` integer, required

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required

## Response `200`

A map of dates to their available timeslots.

- AppointmentTimeslotsByDate: A map of `YYYY-MM-DD` date strings (the timeslot's `start_date`) to their available timeslots.

## Other responses

- `400`: Invalid date range, or the Product is not an appointment Product.
- `404`: Product Not Found.

## Changes

- **2026-10-07** `42f316fe2455`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/jumpseller/apis/jumpseller-api/changes/products/:id/appointment_timeslots.json/get.md)

---

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