---
title: "List available shoot start times"
method: GET
path: "/availability"
tags: ["Availability"]
---

# List available shoot start times

`GET /availability`

## Request

- Base URL: `https://api.snappr.com`
- URL: `https://api.snappr.com/availability`
- Auth: HTTP bearer

Returns available shoot start times for a location, local date, shoot type and duration.
All times within the local date are returned, formatted in UTC.

Provide either `latitude` and `longitude`, or `address`. If both are provided, only
`latitude` and `longitude` are used. Always check availability before creating a booking
with `start_at` set.

## Query parameters

- `latitude` number
- `longitude` number
- `address` string
- `shoottype` string, required
- `duration` integer, required
- `date` string, date, required
- `days_span` integer
- `creator_id` string, uuid

## Headers

- `accept-version` string

## Response `200`

Available start times.

- Availability
  - `latitude` number, required
  - `longitude` number, required
  - `shoottype` string, required
  - `duration` integer, required: Shoot length in minutes.
  - `date` string, date, required
  - `timezone` string, required: IANA timezone of the location.
  - `available_times` string[], required: Available shoot start times, in UTC.

## Other responses

- `400`: The request was invalid, or could not be fulfilled (validation failure, no coverage, no availability, location outside your region).
- `401`: The API key is missing or invalid, or its user is not an admin of the account.
- `429`: Rate limit exceeded (1,000 requests per minute per API key).
- `500`: Unexpected server error. Try again later.

---

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