API reference · v1
Domains
Read sending domains and their DNS verification status. Domains are added and verified in the app.
List domains
GET
/v1/domainsItems omit records (unlike domains.get); call domains.get for DNS records.
Query parameters
- Name
limit- Type
- integer
- Description
- Page size. Clamped to 1..200 with a warning if out of range.
- Name
offset- Type
- integer
- Description
- Rows to skip. Negative values clamp to 0 with a warning; above 10000 returns 400 offset_too_large. pagination.hasMore becomes false when the next offset reaches the cap even if totalCount is larger. Records list has no ad-hoc filter; this is not an unlimited export contract.
Request
curl --fail-with-body 'https://api.maxclicks.ai/v1/domains' \
-H "Authorization: Bearer $MAXCLICKS_API_KEY"Response
{
"data": [
{
"id": "dom_BcwDvBUeSaSDILA5tHgpmU7I",
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-01-15T10:30:00.000Z",
"name": "string",
"customReturnPath": "string",
"verificationStarted": false,
"verifiedForSending": false,
"records": [
{
"type": "string",
"name": "string",
"value": "string",
"priority": 0,
"status": "not started"
}
]
}
],
"pagination": {
"limit": 0,
"offset": 0,
"totalCount": 0,
"hasMore": false
},
"warnings": []
}Status codes
- 200A page of domains.
- 401The API key is missing or invalid.
- 403The key lacks permission, or the space is out of scope.
- 429The rate limit was exceeded.
- 500The API failed to process a valid request.
Get a domain
GET
/v1/domains/{id}Includes live-checked records. Error: domain_not_found.
Path parameters
- Name
id- Type
- string
- Requirement
- Required
- Description
- The domain id.
Request
curl --fail-with-body 'https://api.maxclicks.ai/v1/domains/dom_BcwDvBUeSaSDILA5tHgpmU7I' \
-H "Authorization: Bearer $MAXCLICKS_API_KEY"Response
{
"data": {
"id": "dom_BcwDvBUeSaSDILA5tHgpmU7I",
"createdAt": "2025-01-15T10:30:00.000Z",
"updatedAt": "2025-01-15T10:30:00.000Z",
"name": "string",
"customReturnPath": "string",
"verificationStarted": false,
"verifiedForSending": false,
"records": [
{
"type": "string",
"name": "string",
"value": "string",
"priority": 0,
"status": "not started"
}
]
},
"warnings": []
}Status codes
- 200The domain.
- 401The API key is missing or invalid.
- 403The key lacks permission, or the space is out of scope.
- 404The referenced resource was not found.
- 429The rate limit was exceeded.
- 500The API failed to process a valid request.
Working with these endpoints? See error handling, safe retries, client library guides, and the complete OpenAPI schema.