Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: NogPets Booking API
version: 1.4.0
summary: Run your pet grooming business from any AI assistant; register a pet business from anywhere; book grooming, walks and sitting in Stellenbosch.
description: '**Run your pet business** (tag Run, scope `business:manage`): the owners, managers and
staff of an approved NogPets business run it from their assistant. Today''s day plan per
van or walker, bookings, clients and notes, prices, working hours, time off, service
areas, earnings, payouts and who hasn''t paid; book a phone or walk-in client, rebook,
move or cancel, send a client their Payfast link, and make an invoice link with a QR
code for any amount. Staff read their own day; owners and managers make changes.
Every change is logged with the assistant''s name, and anything that touches bookings,
prices, areas or money answers `CONFIRM_REQUIRED` with a summary first. Booking through
NogPets is for South African businesses (rand, Johannesburg time); elsewhere those tools
answer `NOT_AVAILABLE_IN_COUNTRY` and the rest works in the business''s own currency and
time zone.
**For pet businesses, anywhere in the world** (tag Business, scope `business:write`):
a groomer, dog walker or pet sitter registers and manages their business on NogPets
through their own assistant, in their own country, currency and time zone. Every
application is a draft until NogPets approves it.
**For pet owners in Stellenbosch, South Africa**, where NogPets runs its own vans and
walkers: check coverage, prices and open times without signing in; with the person''s
permission, book, move, cancel and pay, and buy from the shop when it is open. A request
we can''t serve (another town or country, or a fully booked week) is noted for a person
at NogPets to follow up (`NO_COVERAGE` / `NO_AVAILABILITY` with `leadId` and `message`).
- **The person approves money.** A card booking or order comes back with a `payUrl`
the person opens to pay on Payfast. Nothing here takes a card. A cash booking needs
`confirm: true`, sent only after the person has seen the summary and said yes.
- **Same rules as the app.** Prices, coverage, open times and cancellation windows
come from the same server code; the API adds none of its own.
- Booking money is integer cents in South African rand (ZAR): `38000` is R380. Times
are ISO 8601 instants; booking local time is Africa/Johannesburg (UTC+2). A business
application''s prices are in the business''s own `currency` (minor units) and its hours
in its own `timezone`.
- Errors are `{"error": {"code", "message", "details"}}`; `code` is stable
(e.g. `NO_COVERAGE`, `SLOT_TAKEN`, `CONFIRM_REQUIRED`).
Reads marked public need no auth. Everything about a person needs an OAuth 2.1
access token (authorization code + PKCE) or a personal API key, as a Bearer token.
The same operations are MCP tools at `https://mcp.nogpets.com/mcp`.
**Business sign-up, in order** (the first call says the `country`):
startBusinessSignup → addBusinessServices → setServiceArea → addResources → setOperatingHours → inviteStaff
(optional) → connectPayfast (optional, South Africa only, merchant id only) →
getSignupStatus → submitBusinessForReview (`confirm: true` after the person saw the
summary). Every answer carries `next` and a `statusUrl` page for the person.'
contact:
name: NogPets
email: hello@nogpets.com
url: https://nogpets.com/developers
termsOfService: https://nogpets.com/terms
servers:
- url: https://api.nogpets.com
description: Production
security: []
tags:
# --- truncated at 32 KB (48 KB total) ---
# Full source: https://artifacts.apis.io/nogpets-com/openapi/nogpets-com-booking-api-openapi.yml