---
title: "The person's upcoming bookings"
method: GET
path: "/v1/bookings"
tags: ["Booking"]
---

# The person's upcoming bookings

`GET /v1/bookings`

## Request

- Base URL: `https://api.nogpets.com`
- URL: `https://api.nogpets.com/v1/bookings`
- 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

## Query parameters

- `limit` integer

## Response `200`

Bookings

- object
  - `bookings` Booking[], required
    - `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`).

---

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