Skip to main content
The Oviond REST API lets you programmatically manage your agency’s reports, clients, integrations, and automations. All requests are made over HTTPS to https://api.oviond.com.

​
Base URL

​
Authentication

All API requests (except public endpoints) require a Bearer token in the Authorization header:
Generate an API key from Settings → API Keys in the Oviond app. See Authentication for full details.

​
Request format

  • Send JSON bodies with Content-Type: application/json
  • All responses are JSON
  • Timestamps use ISO 8601 format

​
HTTP status codes

Every response uses one consistent JSON envelope. See Errors & request IDs for the full shape.

​
Rate limiting

Programmatic API and MCP traffic is rate-limited per account — the web app is never limited. By default that’s 300 requests per minute per surface; a 429 Too Many Requests response includes a Retry-After header. See Rate limits & retries for the headers and safe-retry guidance.

​
Concepts

Querying data

Pull live metric values from connected data sources.

Authentication

Bearer tokens, API keys, and auth errors.

Errors & request IDs

The response envelope, status codes, and request IDs.

Pagination, filtering & sorting

Page through, search, filter, and sort list results.

Rate limits & retries

Limits, headers, and how to retry safely.

Versioning & stability

What changes are additive vs breaking.

Security & data access

Auth model, tenant isolation, and key handling.