---
title: "Get a booking"
method: GET
path: "/bookings/{booking_uid}"
tags: ["Bookings"]
---

# Get a booking

`GET /bookings/{booking_uid}`

## Request

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

Retrieves one booking by its `uid`.

## Path parameters

- `booking_uid` string, uuid, required

## Headers

- `accept-version` string

## Response `200`

The booking.

- object
  - `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`.
  - `gallery_zip_url` string, uri: Link to download the delivered gallery as a ZIP. Only returned for accounts with gallery ZIP downloads enabled.

## 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.
- `404`: The resource does not exist or does not belong to your 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)