---
title: "One booking"
method: GET
path: "/v1/bookings/{bookingId}"
tags: ["Booking"]
---

# One booking

`GET /v1/bookings/{bookingId}`

## Request

- Base URL: `https://api.nogpets.com`
- URL: `https://api.nogpets.com/v1/bookings/{bookingId}`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.nogpets.com/oauth/authorize`, token URL `https://api.nogpets.com/oauth/token`, scopes: `bookings:read`)
  - HTTP bearer

## Path parameters

- `bookingId` string, required

## Response `200`

The booking

- Booking
  - `id` string, required
  - `category` string, required
  - `what` string
  - `start` string, date-time, required
  - `end` string, date-time
  - `when` string
  - `address` object
    - `label` string
    - `line1` string
    - `suburb` string
    - `mapUrl` string, nullable: The address on Google Maps.
  - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'CANCELLED' | 'COMPLETED', required
  - `paymentMethod` 'CARD' | 'CASH', required
  - `paymentStatus` 'PENDING' | 'PAID' | 'CASH_DUE' | 'CASH_RECEIVED' | 'REFUND_REQUESTED' | 'REFUNDED' | 'FAILED', required
  - `totalCents` integer, required
  - `total` string
  - `discount` Discount
    - `code` string, required
    - `amountCents` integer, required: What came off the price (never the card fee).
    - `auto` boolean
  - `crew` string[]
  - `seriesId` string, nullable
  - `canPay` boolean
  - `source` string

## Other responses

- `401`: No token, or it's expired or revoked. The `WWW-Authenticate` header points at the resource metadata.
- `403`: The token lacks a scope (`INSUFFICIENT_SCOPE`, with `details.scope`).
- `404`: Not found, or not the person's.

---

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