Overview

The United Pet Club Partner API is a versioned REST API at https://api.unitedpetclub.com that lets an approved application read and, for some resources, write platform data on behalf of a United Pet Club account — animals, appointments, health records, orders, marketplace listings, content, social publishing and more.

How access works

1. Your application is registered. You get a client_id, and a client_secret unless the app is a public client. Register an app for the Partner API yourself under Account → Developer → Applications, or let the software register itself at POST https://auth.unitedpetclub.com/connect/register — the way in for WordPress plugins, AI-built websites and AI agents (see WordPress plugins and AI agents). See Support for other access.
2. You exchange the credentials for a short-lived access token — with the client-credentials grant for your application itself, or with the authorization-code grant after a business connects your app on the United Pet Club consent page (the Partner API: booking, appointments, clients and webhooks for that business). See Authentication.
3. You call the API with that token. Every request is authorized against the scopes the token carries and the permissions behind them. Calls outside either return 403.

A token is bound to whom it acts for — your application’s account, or the one business that connected your app. There is no account or business parameter to pass.

What it costs

The API is free, for you and for the businesses that connect your app. A business can connect an app, and its apps can act for it, only while it keeps a valid payment card on file (Dashboard → Finances → Billing). The platform takes its fees on the bookings and services an app creates from the business’s payouts, and charges the card for what the payouts do not cover. Without a card, the consent page does not let the business allow your app, and the Partner API answers 403 with platformResponseCode 0010010000407 for that business. Registering an app needs no card.

The contract in one table

Concern	How it works	Read more
Base URL	https://api.unitedpetclub.com/api/{resource}/v1/…	Versioning
Auth	Authorization: Bearer <access token> on every request; client credentials, or a business’s authorization code (PKCE; no secret for a public client)	Authentication
Discovery	/.well-known/oauth-protected-resource on the API host and /.well-known/oauth-authorization-server on the token host (RFC 9728, RFC 8414)	Discovery metadata
Errors	RFC 7807 application/problem+json with a stable platformResponseCode and a correlationId	Errors
Rate limits	Per application and per connected account or business; X-RateLimit-* headers on every response, 429 + Retry-After when exceeded	Rate limits
Lists	page (1-based) and pageSize (1–100); responses carry data + pagination	Pagination
Reference	Live OpenAPI document and interactive console at https://api.unitedpetclub.com/docs	API reference

Where to start

• Quickstart — get a token and make a first call in five minutes.
• WordPress plugins and AI agents — software that registers itself and connects to a business on its own.
• API reference — the resource families, and the interactive console where you can try requests with your own credentials.

Resource availability

The authentication, error and rate-limit contract on these pages is live. Individual resource families are being enabled progressively; the API reference lists them and the hosted OpenAPI document is always the authoritative view of what is callable. Ask Support before building against a resource not yet marked available.