API Reference

The Praevis Exchange API is a REST API served over HTTPS. All endpoints return JSON. The base URL for all requests is:

https://api.praevis.com/v1

Endpoints

Section	Base path	Description
Authentication	`/auth`	API keys, JWT tokens, partner tokens
Supply API	`/supply`	Supply source (Publisher) management, pools, floor prices
Demand API	`/demand`	Demand source (DSP) management, targeting, bid configuration
Metrics API	`/metrics`	Revenue, impressions, fill rate, latency
Partner API	`/partner`	Platform partner management and reporting
Sandbox API	`/sandbox`	Test traffic generation, synthetic demand source control
Errors & Status Codes	—	Error shapes, HTTP status codes, retry guidance

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_...

API keys are scoped by role — supply, demand, partner, or admin. See Authentication for key management and token refresh.

Request / Response conventions

Content type: application/json for all request bodies.

Pagination: List endpoints use cursor-based pagination:

{
  "data": [...],
  "next_cursor": "cur_abc123",
  "has_more": true
}

Timestamps: All timestamps are ISO 8601 UTC — 2026-02-18T14:32:00Z.

Currency: All monetary values are in micro-dollars internally. API responses return cents as float64. Do not divide by 100 — the dashboard handles display conversion.

Errors: All errors follow a consistent shape — see Errors & Status Codes.

Rate limits

Key type	Rate limit
Supply / Demand	1,000 req/min
Partner	500 req/min
Admin	2,000 req/min
Metrics (bulk export)	60 req/min

Rate limit headers are included on every response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1708264800

Environments

Environment	Base URL	Notes
Production	`https://api.praevis.com/v1`	Live data
Sandbox	`https://sandbox.api.praevis.com/v1`	Test data, no billing

Sandbox API keys are prefixed sk_sandbox_. See Sandbox API for synthetic traffic and test DSP controls.

Authentication