Domain Monitoring

The domain monitoring endpoint returns registration and expiration data for a domain, including RDAP information and domain status codes. This is useful for tracking domain expiry on any monitor with the domain check enabled.

You'll need a monitor ID for this endpoint.

Example request:

$ OHDEAR_TOKEN="your API token"
$ curl https://ohdear.app/api/monitors/1/domain \
    -H "Authorization: Bearer $OHDEAR_TOKEN" \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json'

All endpoints below follow the same authentication pattern.

Get domain information #

GET /api/monitors/{monitorId}/domain

Returns the current domain registration and expiration information for a monitor.

Here's what the response looks like:

{
  "expires_at": "2026-05-15T00:00:00.000000Z",
  "registered_at": "2018-03-20T00:00:00.000000Z",
  "last_changed_at": "2025-01-10T12:30:00.000000Z",
  "last_updated_in_rdap_db_at": "2025-02-01T08:00:00.000000Z",
  "domain_statuses": {
    "client delete prohibited": false,
    "client transfer prohibited": true,
    "client update prohibited": false
  },
  "rdap_domain_response": { "...": "..." },
  "created_at": "2024-06-15T14:30:00.000000Z"
}

• expires_at: when the domain registration expires (UTC)
• registered_at: when the domain was first registered (UTC)
• last_changed_at: when the domain registration was last modified (UTC)
• last_updated_in_rdap_db_at: when the RDAP database record was last updated (UTC)
• domain_statuses: an object where each domain status code maps to a boolean indicating whether that status is active
• rdap_domain_response: the raw RDAP response object
• created_at: when Oh Dear first recorded this domain information (UTC)

Error handling #

This endpoint returns 422 Unprocessable Entity when:

• The site is not supported by the domain check
• The domain check is not enabled
• We don't have domain data yet -- check back later