Base URL
Authentication
All requests require a bearer token. The same API keys used for the Main API are accepted here. See Authentication.Capabilities
| Group | What it does |
|---|---|
| Email health | Validate addresses, detect role accounts, check domain reputation |
| DNS | Look up SPF, DKIM, DMARC, MX records — used by domain-setup wizards |
| SMS | Dispatch SMS messages and check delivery |
| AI text tools | Score, classify, and generate content snippets |
| Customer data | Read-only lookups for enriched customer records |
| Quota | Inspect remaining credits on metered operations |
When to use Extended over Main
| Use Extended API for… | Use Main API for… |
|---|---|
| Per-request validation in a signup form | CRUD on contacts, segments, journeys |
| Domain-setup wizards in your own UI | Triggering campaigns and journeys |
| High-volume scoring at the edge | Reading reporting and analytics data |
| Quota and credit lookups | Managing organisation and project state |
Versioning
The current version isv1. The OpenAPI specification is published at:
https://app.spotzee.com/api/ext/docs.
Rate limits
Per-API-key rate limits apply. Quota-metered endpoints (validation, scoring) deduct credits on success — checkQuota endpoints before high-volume runs.
Errors
See the Extended API errors reference.Next
Authentication
API keys and scopes.
Errors
Status codes and error bodies.