Domains

Get domain details by hostname

get/domains/by-host/{hostname}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/domains/by-host/{hostname}
  • Auth: HTTP bearer

Path parameters

hostnamestring required

Domain hostname

Response

Domain details retrieved successfully

certificatestring nullable

The PEM-encoded certificate chain (can be displayed in browser or downloaded)

created_atinteger required
dns_challenge_tokenstring nullable
dns_challenge_valuestring nullable
domainstring required
expiration_timeinteger nullable
idinteger required
is_wildcardboolean required
last_errorstring nullable
last_error_typestring nullable
last_renewedinteger nullable
on_demand_backoff_untilinteger nullable

On-demand TLS negative-cache deadline (epoch millis), when this hostname's on-demand HTTP-01 issuance is in backoff after a failure (ADR-018 §4). None means no active backoff.

statusstring required
updated_atinteger required
verification_methodstring required

Changes

No recorded changes to this operation across all 50 revisions of this API.