---
title: "Price for these pets at this address"
method: POST
path: "/v1/quote"
tags: ["Booking"]
---

# Price for these pets at this address

`POST /v1/quote`

## Request

- Base URL: `https://api.nogpets.com`
- URL: `https://api.nogpets.com/v1/quote`
- Auth: none required

The server's price and duration for one visit. Pets and address by value (no account needed), or saved ones (`addressId`, `petId`) with a token.

## Request body

- QuoteRequest
  - `category` string, required: A service line id: grooming, walking or sitting.
  - `address` string: Typed address with the suburb or postal code, or "lat,lng".
  - `lat` number
  - `lng` number
  - `postalCode` string
  - `addressId` string: A saved address (needs a token with the addresses scope).
  - `pets` PetLine[], required
    - `petId` string
    - `name` string
    - `type` 'DOG' | 'CAT'
    - `weightKg` number
    - `coat` 'SHORT' | 'MEDIUM' | 'LONG'
    - `serviceIds` string[], required: Service ids from list_services; exactly one PRIMARY plus any EXTRAs of the same line. A package id (a line's `packages`) stands for its main service and extras.
    - `packageId` string: A package from list_services (same as putting it in serviceIds).
  - `promoCode` string: A promo code (e.g. WELCOME30). Leave it out to apply a code the person claimed on nogpets.com (matched by their mobile); send "" for none.

## Response `200`

The quote

- Quote
  - `category` string, required
  - `durationMin` integer, required
  - `pets` object[], required
    - `petId` string
    - `name` string, required
    - `items` Item[], required
      - `serviceId` string, required
      - `name` string, required
      - `kind` 'PRIMARY' | 'EXTRA', required
      - `priceCents` integer, required
      - `durationMin` integer, required
    - `package` object: The package chosen; items are its parts at list price and savingCents comes off.
      - `id` string
      - `name` string
      - `savingCents` integer
  - `subtotalCents` integer, required
  - `cardFeeCents` integer, required
  - `cardTotalCents` integer, required
  - `cashTotalCents` integer, nullable: Null when cash isn't taken. After the discount.
  - `discount` Discount
    - `code` string, required
    - `amountCents` integer, required: What came off the price (never the card fee).
    - `auto` boolean
  - `discountError` 'UNKNOWN' | 'INACTIVE' | 'NOT_STARTED' | 'EXPIRED' | 'USED_UP' | 'NOT_APPLICABLE' | 'NOT_FIRST' | 'LIMIT_REACHED' | 'MIN_SUBTOTAL' | 'null', nullable: Why promoCode can't be used. The quote is then without it.
  - `acceptsCash` boolean, required
  - `group` object, nullable: A group walk: {serviceId, size, dogs}.
  - `summary` string, required

## Other responses

- `400`: The input is wrong (`INVALID_ARGUMENT`, or a pricing code such as `ONE_PRIMARY`, `PET_TYPE`, `UNKNOWN_SERVICE`).
- `401`: No token, or it's expired or revoked. The `WWW-Authenticate` header points at the resource metadata.
- `409`: A rule said no: `NO_COVERAGE`, `NO_AVAILABILITY`, `SLOT_TAKEN`, `TOO_LATE`, `CONFIRM_REQUIRED` (with `details.summary`), `NOTHING_TO_PAY`, `SHOP_OFF`, `STOCK`, `SHIPPING`, `DISCOUNT`, `CASH`, `FAILED_PRECONDITION`; business sign-up: `UNDER_REVIEW`, `APPROVED`, `NOT_READY`, `TOO_MANY`, `LISTING_TAKEN`, `PAYFAST_ZA_ONLY`. `NO_COVERAGE` carries `details.leadId`, `details.message` (tell the person) and `details.next`.
- `429`: Too many requests (`RATE_LIMIT`). `Retry-After` says when to try again.

---

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