REST API Overview
Expirity’s REST API gives you read access to your domain and client data - useful for pulling monitoring status into your own dashboards, scripts, or internal tooling instead of checking the console manually. Available on Pro and Agency.
For full endpoint reference, request/response schemas, and to try requests interactively, see the API reference. This page covers the essentials to get started.
Authentication
Section titled “Authentication”Every request requires a Bearer token in the Authorization header:
Authorization: Bearer <your-api-key>Generate a key from Integrations in the console - see Generating an API Key.
What’s available
Section titled “What’s available”GET /api/v1/domains- list your monitored domains, with filters for expiry window, specific domain, and (on Agency) clientGET /api/v1/clients- list your client folders (Agency only)
All responses are paginated and return data in a consistent envelope with data and meta fields.
Rate limits
Section titled “Rate limits”Requests are limited to 60 per minute per API key. If you exceed this, you’ll get a 429 response with a Retry-After header - wait the indicated time before retrying.
A note on what’s not here yet
Section titled “A note on what’s not here yet”The current API is read-only. Write operations (adding or modifying domains via API) aren’t available yet - domain management happens through the console.