Sign in
Domains

Finalize ACME order for a domain

Finalizes the ACME order by completing the challenge validation and requesting the certificate. This should be called after the challenge has been set up (DNS record added or HTTP token served).

post/domains/{domain_id}/order/finalize

Request

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

Path parameters

domain_idinteger required

Domain ID

Response

Order finalized 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.