# Gingr Bookings API

**Canonical:** https://apis.io/apis/gingr/gingr-bookings-api/  
**Provider:** Gingr — https://apis.io/providers/gingr/  
**Base URL:** https://api.gingr.io/v1  
**Documentation:** https://support.gingrapp.com/hc/en-us/articles/25722122517517-Gingr-API-Functions-Reference

Gingr Bookings API is one of 12 APIs that [Gingr](https://apis.io/providers/gingr/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Booking. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The **Bookings** group is the core of the Gingr API. A **Booking** (also called a Reservation internally) represents a scheduled service for one or more animals at a specific location and time. The typical booking lifecycle is: 1. **Validate** — Call the validation endpoints to check availability and confirm there are no conflicts before committing. 2. **Create** — Submit the booking with the required fields. The response includes the new booking ID. 3. **Pre-check** — If the organization requires a pre-check, retrieve the pre-check form (`GET /v1/bookings/{id}/precheck-form`) and submit answers (`POST /v1/bookings/{id}/precheck`). 4. **Accept / Confirm** — Some organizations require staff to manually confirm bookings. Use the accept endpoint when `manualConfirm` is enabled. 5. **Checkout** — When the service is complete, submit payment via the checkout endpoint. 6. **Cancel** — If needed, cancel the booking and optionally apply a cancellation fee. Key concepts: - **`manualConfirm`** — When this flag is `true` on a booking type, new bookings land in a "pending" state and must be explicitly accepted by staff before they are considered confirmed. If `false`, bookings are auto-confirmed. - **Overrides** — The `overrides` object in the create/update requests lets you bypass certain business rule validations (e.g., overbooking a run, scheduling outside business hours). Overrides require elevated API permissions and should be used sparingly. - **Services** — A booking can have one or more services attached (e.g., the base boarding service plus grooming add-ons). Services carry their own pricing and scheduling. - **Lodging** — For overnight boarding, the booking is assigned to a specific run/kennel. The available lodgings endpoint returns which runs are open for the requested dates. - **Pre-check** — A digital check-in form that collects health, feeding, and care instructions for the animal's stay. Whether pre-check is required depends on organization settings. - **Standing Bookings** — Recurring bookings on a fixed schedule (e.g., every Monday for daycare). Changes to a standing booking can apply to the single instance or all future occurrences.

## Operations (42)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/bookings/available-specialists` | Available Specialists - List |
| GET | `/v1/bookings/next-available-specialists` | Available Specialists - List Next |
| GET | `/v1/bookings/{bookingId}/feeding-administration-status` | Feeding Administration Status - List |
| PUT | `/v1/bookings/{bookingId}/feeding-administration-status` | Feeding Administration Status - Save |
| GET | `/v1/bookings/{bookingId}/medication-administration-status` | Medication Administration Status - List |
| PUT | `/v1/bookings/{bookingId}/medication-administration-status` | Medication Administration Status - Save |
| POST | `/v1/bookings/{bookingId}/belongings` | Booking Belonging - Create |
| PUT | `/v1/bookings/{bookingId}/belongings/{belongingId}` | Booking Belonging - Update |
| DELETE | `/v1/bookings/{bookingId}/belongings/{belongingId}` | Booking Belonging - Delete |
| POST | `/v1/bookings/{bookingId}/check-in` | Booking - Check In |
| GET | `/v1/bookings/estimates` | [BETA – Not Production Ready] Bookings - Estimates |
| GET | `/v1/bookings` | Bookings - List |
| POST | `/v1/bookings` | Bookings - Create |
| GET | `/v1/bookings/{bookingId}` | Bookings - Details |
| PUT | `/v1/bookings/{bookingId}` | Bookings - Update |
| GET | `/v1/bookings/available-lodgings` | Bookings - Available Lodgings |
| PUT | `/v1/bookings/{bookingId}/services` | Booking Service - Add |
| GET | `/v1/bookings/last-service-duration` | Bookings - Last Service Duration |
| POST | `/v1/bookings/booking-estimate` | Bookings - Generate Estimate |
| PUT | `/v1/bookings/{bookingId}/cancel` | Bookings - Cancel |
| GET | `/v1/bookings/{bookingId}/estimate` | Booking - Estimate |
| GET | `/v1/bookings/{bookingId}/precheck` | Booking - Precheck Data |
| POST | `/v1/bookings/{bookingId}/precheck` | Booking Precheck - Submit |
| POST | `/v1/bookings/{bookingId}/checkout` | Bookings - Checkout |
| POST | `/v1/bookings/{bookingId}/accept` | Bookings - Accept |
| POST | `/v1/bookings/{bookingId}/wait-list` | Booking - Move to Wait List |
| DELETE | `/v1/bookings/{bookingId}/booking-services/{bookingServiceId}` | [BETA - Not Production Ready] Booking Service - Delete |
| DELETE | `/v1/bookings/{bookingId}/booking-service-options/{bookingServiceOptionId}` | [BETA - Not Production Ready] Booking Service Option - Delete |
| POST | `/v1/bookings/{bookingId}/booking-services/{bookingServiceId}/complete` | [BETA - Not Production Ready] Booking Service - Complete |
| POST | `/v1/bookings/{bookingId}/booking-service-options/{bookingServiceOptionId}/complete` | [BETA - Not Production Ready] Booking Service Option - Complete |
| GET | `/v1/bookings/validate-capacity` | [Deprecated] Bookings - Validate Capacity |
| POST | `/v1/bookings/validate-capacity` | Bookings - Validate Capacity |
| GET | `/v1/bookings/validate-forms` | Bookings - Validate Forms |
| GET | `/v1/bookings/validate-immunizations` | [BETA – Not Production Ready] Bookings - Validate Immunizations |
| GET | `/v1/bookings/validate-agreements` | Bookings - Validate Agreements |
| GET | `/v1/bookings/validate-prior-bookings` | Bookings - Validate Prior Bookings |
| GET | `/v1/bookings/deposits` | Bookings Deposits - List |
| GET | `/v1/bookings/validate-evaluations` | Bookings - Validate Evaluations |
| GET | `/v1/bookings/default-rates` | Bookings Default Rates - List |
| GET | `/v1/bookings/standing-bookings/pets/{petId}` | Standing Bookings - List |
| POST | `/v1/bookings/standing-bookings/{standingBookingId}/cancel` | Standing Bookings - Cancel |
| DELETE | `/v1/bookings/standing-bookings/{standingBookingId}` | Standing Bookings - Delete |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gingr/refs/heads/main/openapi/gingr-bookings-api-openapi.yml
- **Documentation** — https://docs.gingr.io/documentation
- **Documentation** — https://support.gingrapp.com/hc/en-us/sections/26779521691661-Gingr-s-API

## Other Gingr APIs (11)

- [Gingr Invoices API](https://apis.io/apis/gingr/gingr-invoices-api/)
- [Gingr Payments API](https://apis.io/apis/gingr/gingr-payments-api/)
- [Gingr Pets API](https://apis.io/apis/gingr/gingr-pets-api/)
- [Gingr Booking Type Rates API](https://apis.io/apis/gingr/gingr-booking-type-rates-api/)
- [Gingr Card On File API](https://apis.io/apis/gingr/gingr-card-on-file-api/)
- [Gingr Config API](https://apis.io/apis/gingr/gingr-config-api/)
- [Gingr Group Classes API](https://apis.io/apis/gingr/gingr-group-classes-api/)
- [Gingr Parents API](https://apis.io/apis/gingr/gingr-parents-api/)
- [Gingr Payment API](https://apis.io/apis/gingr/gingr-payment-api/)
- [Gingr Precheck API](https://apis.io/apis/gingr/gingr-precheck-api/)
- [Gingr Upload API](https://apis.io/apis/gingr/gingr-upload-api/)

## Tags

Booking

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gingr/gingr-bookings-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gingr/.