---
title: "Find next available scheduling slots"
method: GET
path: "/api/v1/slots/next"
tags: ["Slots"]
---

# Find next available scheduling slots

`GET /api/v1/slots/next`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/slots/next`
- Auth: HTTP bearer

## Query parameters

- `account_ids` string: Comma-separated account IDs, at most 50 (more answers 400). Ids you cannot use are ignored, and the call answers 404 only when none of them is usable. Posts a teammate scheduled on a shared account count as collisions.
- `timezone` string
- `count` integer
- `workspace_id` string

## Response `200`

Slots generated successfully

- SlotsResponse
  - `slots` object[], required
    - `time` string, date-time, required
    - `local_time` string, required

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `404`: Resource not found
- `429`: Too many requests

---

[API](https://skmtc.dev/poster/apis/posterly-api.md) · [All operations](https://skmtc.dev/poster/apis/posterly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/poster/apis/posterly-api/revisions/60be02a61f95?raw)