---
title: "List bookings"
method: GET
path: "/bookings"
tags: ["Bookings"]
---

# List bookings

`GET /bookings`

## Request

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

Lists your account's bookings, most recently updated first.

## Query parameters

- `limit` integer
- `offset` integer
- `status` string

## Headers

- `accept-version` string

## Response `200`

A page of bookings.

- object
  - `count` integer, required: Number of items in this page.
  - `limit` integer, required
  - `offset` integer, required
  - `total` integer, required: Number of items across all pages.
  - `results` Booking[], required
    - `uid` string, uuid, required
    - `package_id` string, uuid, nullable: The Snappr package (product) the booking was placed on.
    - `title` string, nullable
    - `status` string, required: Booking status, e.g. `paid`, `paid_pending_schedule`, `completed`, `cancelled`.
    - `credits` integer, required: Credits charged for the booking.
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `shoottype` string, nullable
    - `start_at` string, date-time, nullable
    - `duration` integer, nullable: Shoot length in minutes.
    - `location_notes` string, nullable
    - `style_notes` string, nullable
    - `customer_firstname` string, nullable
    - `customer_surname` string, nullable
    - `customer_email` string, nullable
    - `customer_mobilephone` string, nullable
    - `customer_company` string, nullable
    - `internal_id` string, nullable
    - `creator_name` string, nullable: Assigned photographer's first name and last initial.
    - `creator_id` string, uuid, nullable
    - `creator_profile_image_url` string, uri, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `update_at` string, date-time: Misspelled alias of `updated_at`, kept for backwards compatibility.
    - `photographer_name` string, nullable: Old name for `creator_name`.

## 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)