Request certificate

POST

/certificates/{id}/request

Requests the actual certificate for a package that was bought with POST /certificates/order. Send the private key belonging to the CSR to have it stored with the certificate; it is never returned again. After this call, poll GET /certificates/{id} to follow the validation and to download the issued certificate.

With validation_method dns you can set auto_setup_dns to have the required CNAME record published for you, which only works when the domain is in your account and uses our nameservers. The certificate is still requested when that fails; the response then carries a warning and the record has to be created manually.

Request

Authorization

API Key

Add parameter in header

API-key

Example:

API-key: ********************

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "profile_id": 12345,
    "csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----",
    "validation_method": "dns",
    "approver_email": "beheer@example.com",
    "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----",
    "auto_setup_dns": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mijn.host/api/v2/certificates/12345/request' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "profile_id": 12345,
    "csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----",
    "validation_method": "dns",
    "approver_email": "beheer@example.com",
    "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----",
    "auto_setup_dns": true
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "status": 200,
    "status_description": "Request successful",
    "data": {
        "id": 12345,
        "domain": "example.com",
        "requested": true
    }
}

🟠400Certificate not found

🟠400This certificate has already been requested

🟠400Wrong request method

🟠400SSL connection is required

🟠401No valid API key set

🟠401API key has expired

🟠401Remote IP address is not found in the API key whitelist

🔴500Error

Modified at 2026-08-20 12:45:15

Generate CSR

List orders