AT AppointmentTrader
Sign In
Online Now  
Partner Programs API Integration · Public REST

Call AT
from anywhere.

One auth-gated REST surface for every reservation, bid, transaction, and venue on AppointmentTrader. Plain HTTPS, JSON in and out, predictable error shapes — the same endpoints that power the AT web app, available to your servers.

Read the docs Get an API key
  • 120+public endpoints
  • 99.9%uptime, last 12 months
  • <120msp95 latency, edge
curl · any language JavaScript SDK Python SDK PHP SDK REST · JSON API key · HMAC Webhooks · signed
How it works

Three steps. One key. Five minutes to first call.

  1. 01

    Get an API key

    Free, instant, scoped. Public endpoints work without one; user-scoped endpoints need an API key plus a per-user grant. No salesperson, no waitlist — the form lives at /api-documentation.

  2. 02

    Hit /v1/...

    Plain HTTPS, JSON in and out, predictable error shapes. Everything the AppointmentTrader web app uses is here, documented, with example requests and response schemas. No GraphQL gateway, no protocol surprise.

  3. 03

    Need a UI inside AT?

    Switch tracks. The App Development path wraps your app in the AT shell — same endpoints, plus the SDK, sidebar entry, and portal install.

Endpoint families

Six surfaces. One contract.

Full reference

Market data

Public
/v1/marketdata/get_world_top

Trending cities, cover prices, fill rates, recent transactions. The same surface that powers the AT public marquee — SSR-friendly, JSON-typed, paginated.

Bids & offers

API key
/v1/concierge/categorize_request

Submit a buyer intent, get a parsed venue match. Fetch open bids, place a counter, drop a bid. The same shape used by the in-app intent composer.

Transactions

API key
/v1/transaction/list

Authenticated transaction history per user, filtered by status, date range, location. Webhook subscriptions for state changes (paid, transferred, refunded).

Locations

Public
/v1/location/search

Venue search, autocomplete, hours, capacity, photos. The same database powering the AT search bar — indexed across 12 categories from restaurants to DMV slots.

Notifications

API key
/v1/notification/subscribe

Push, email, SMS subscriptions per user. Topic-scoped (bid filled, transaction confirmed, message received). Standard webhook signing on egress.

User & social

API key
/v1/user/get_profile

Profiles, ratings, follow graph, activity feeds. Read-only on the public surface; full CRUD when called from inside an app-host iframe with a valid SDK token.

120+
public endpoints across six surfaces
99.9%
12-month uptime, public & authenticated surface
<120ms
p95 latency from edge, every region
$0
free tier, no credit card to start
FAQ

The honest answers.

What does it cost?

Free for the public surface (market data, location search) at fair-use rates. User-scoped endpoints — the ones that touch a real user's bookings — are free for the first 10,000 calls per month, then metered. App-host distribution (your app inside /apps/{id}/) is free; we revenue-share only on transactions you originate.

What are the rate limits?

60 req/min on the public surface, unauthenticated. 600 req/min with an API key. User-scoped endpoints get a sliding window per user; soft-fail at the limit, hard-fail after sustained abuse. Every response carries X-RateLimit-Remaining and X-RateLimit-Reset — no surprises.

Is there a sandbox?

Yes. Append ?sandbox=1 to any endpoint, or hit the same path on sandbox.appointmenttrader.com. Same shapes, same auth, fixture data — transactions don't move real money, notifications don't ship to real users, and you can reset the world from the partner dashboard.

Do you support webhooks?

Yes — HMAC-signed, retried with backoff, replayable from the dashboard. Subscribe per-topic (bid.filled, transaction.confirmed, message.received, etc.) with an API key plus a per-user grant. We deliver from a stable IP range you can allowlist; logs and replays live in the partner dashboard for 30 days.

When should I switch to App Development instead?

When your users live inside AppointmentTrader. Direct API: your app, your servers, your distribution — users grant your API key access from their settings, you call /v1/ from a backend you own. App Development: your app loads inside an iframe on AT, gets a sidebar entry, an SDK token auto-issued for the active user, and ships into the user's portal beside our own surfaces. Same endpoints, same data, different reach — pick by where your users already are.

How do I get a key?

/api-documentation#auth. Sign in to AT, click Generate, copy the key. The first request can land 30 seconds later. There's no review queue for the public tier; user-scoped grants flip on per-app review (typically same-day).

Your code, our marketplace. Start in five minutes.

Free tier. No credit card. No sales call. The same surface that powers everything you see on AppointmentTrader.

Read the docs Back to Partner Programs

120+ public endpoints. 99.9% uptime. p95 under 120ms.