Get a domain and its health
GET/api/v1/domains/:domain
The domain with the results of dotMARC's last DNS checks. The API never runs checks itself; checkedUtc says when each last ran. Accepts the domain's id or its name, such as contoso.example.
Needs the DomainsView permission.
Request
Responses
- 200
- 401
- 403
- 404
- 429
- 500
OK
No API key was sent, or the key is unknown, expired or revoked.
The key's role doesn't have the permission this operation needs, or the key is limited to certain groups and this would reach outside them. detail says which.
There's no such item, or this key can't see it. A key limited to certain groups can't see what's outside them.
This key has made more requests this minute than dotMARC allows (120 by default). Wait for the number of seconds in the Retry-After header, then try again.
Something went wrong in dotMARC that the request didn't cause. It's safe to retry a read; check before retrying a change. If it keeps happening, dotMARC's logs have the details.