Pazar API

The Pazar API is how you hook your own app into Pazar. Read your listings, invite partners to licensing deals, drive deal rooms, and receive deal lifecycle webhooks. Everything is scoped to the organisation your API key belongs to.

Base URL

https://api.pazar-ip.com

All versioned endpoints live under /v1. The unauthenticated liveness probe is at /health.

Authentication

Every /v1 endpoint requires a Bearer API key in the Authorization header. Keys are organisation-scoped. One key acts on behalf of one Pazar org. Create one in Settings → Integrations (the API Keys tab). Keys are prefixed pzr_live_ / pzr_test_. Treat them like passwords; the full secret is shown only once.

Authorization: Bearer pzr_live_xxxxxxxxxxxxxxxx

Hook it up & test

1. Mint a key. 2. Confirm the surface is reachable. 3. Verify your key (doubles as a "whoami").

# 1) reachability (no auth)
curl https://api.pazar-ip.com/health

# 2) verify the key (200 returns your org name)
curl https://api.pazar-ip.com/v1/verify \
  -H "Authorization: Bearer $PAZAR_API_KEY"

Errors

Errors are JSON { "error": "…" } with a matching HTTP status. 401: missing/invalid/revoked/expired key (never says which). 400: bad request body. 404: not found or not owned by your org. 201: resource created.