Certificate orders
An order is the issuance workflow: identifiers, validation method, provider, challenges and the resulting certificate_id.
Purpose
POST /api/v1/certificates creates an order. Read GET /api/v1/certificate-orders/{id} for status, challenges and error_code.
Expected states
pending, validating, issued, failed, validation_failed. Sandbox often jumps to issued. Staging ACME stays pending until challenges complete.
Validate
POST /certificate-orders/{id}/validate after you publish HTTP-01 or DNS-01 material. The platform does not invent a successful CA response.
Errors
wildcard_requires_dns, acme_validation_failed, ca_rate_limited, dns_propagation_timeout, provider_unavailable.
Related
Validation /docs/validation. Renewals /docs/renewals. Product /ssl-certificate-api.