Need help? Call Live Support at +31 (0) 38 453 07 59

Used to request a certificate

  • POSTMethod
  • /v2/ssl/certificatesURL
  • application/jsonContent-Type
Name Type Required / Optional Description Restrictions
quote Boolean Optional If true, validate the request and request a quote for the action
Name Type Required / Optional Description Restrictions
customer String Required The customer handle
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
product String Required The product defines the type of certificate to create
period Integer Required The validity period of the certificate in months
csr String Required A valid Certificate Signing Request
san List <String> Optional List of SAN domains
  • Regular expression: (?:\*\.)?(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])
  • Minimum length: 4
  • Maximum length: 255
organization String Optional The organization, overrides the Organization field in CSR
  • Minimum length: 1
  • Maximum length: 30
department String Optional The department, overrides the Organisational Unit field in CSR
  • Minimum length: 1
  • Maximum length: 30
address String Optional The address, see requiredFields/optionalFields in ssl product metadata for usage
  • Minimum length: 1
  • Maximum length: 30
postalCode String Optional The postal code, see requiredFields/optionalFields in ssl product metadata for usage
  • Minimum length: 1
  • Maximum length: 10
city String Optional The city, overrides the City field in CSR
  • Minimum length: 1
  • Maximum length: 30
coc String Optional Chamber Of Commerce identifier, see requiredFields/optionalFields in ssl product metadata for usage
  • Minimum length: 1
  • Maximum length: 30
saEmail String Optional Recipient for the Subscriber Agreement, see requiredFields/optionalFields in ssl product metadata for usage
  • Regular expression: (?=.{1,64}@)[a-z0-9_\-+]+(?:\.[a-z0-9_\-+]+)*@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])
  • Minimum length: 6
  • Maximum length: 255
saLanguage String Optional Preferred language for the Subscriber Agreement, see requiredFields/optionalFields in ssl product metadata for usage
  • Minimum length: 1
  • Maximum length: 15
approver approver Optional Approver of the certificate, see requiredFields/optionalFields in ssl product metadata for usage.
dcv List <dcv> Optional List of DCVs for this certificate
Name Type Required / Optional Description Restrictions
firstName String Required First name of the approver
  • Minimum length: 1
  • Maximum length: 30
lastName String Required Last name of the approver
  • Minimum length: 1
  • Maximum length: 30
email String Required Email address of the approver
  • Regular expression: (?=.{1,64}@)[a-z0-9_\-+]+(?:\.[a-z0-9_\-+]+)*@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])
  • Minimum length: 6
  • Maximum length: 255
voice String Required The voice telephone number of the approver
  • Regular expression: \+[0-9]{1,3}\.[0-9]{1,14}
  • Minimum length: 4
  • Maximum length: 17
Name Type Required / Optional Description Restrictions
commonName String Required The common name for this DCV entry
  • Regular expression: (?:\*\.)?(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])
  • Minimum length: 4
  • Maximum length: 255
type Enum Required The validation type used for this DCV entry

Possible values:

  • EMAIL: Email
  • FILE: File
  • DNS: DNS
email String Optional The email address for this DCV entry, required if 'type' is set to 'EMAIL'
  • Regular expression: (?=.{1,64}@)[a-z0-9_\-+]+(?:\.[a-z0-9_\-+]+)*@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])
  • Minimum length: 6
  • Maximum length: 255

Successful request

  • 202 AcceptedHTTP Status

Response is the same as info process

Failed requests

Generic errors can be expected.

If true, validate the request and request a quote for the action
The customer handle
The product defines the type of certificate to create
The validity period of the certificate in months
A valid Certificate Signing Request
List of SAN domains
The organization, overrides the Organization field in CSR
The department, overrides the Organisational Unit field in CSR
The address, see requiredFields/optionalFields in ssl product metadata for usage
The postal code, see requiredFields/optionalFields in ssl product metadata for usage
The city, overrides the City field in CSR
Chamber Of Commerce identifier, see requiredFields/optionalFields in ssl product metadata for usage
Recipient for the Subscriber Agreement, see requiredFields/optionalFields in ssl product metadata for usage
Preferred language for the Subscriber Agreement, see requiredFields/optionalFields in ssl product metadata for usage
First name of the approver
Last name of the approver
Email address of the approver
The voice telephone number of the approver
The common name for this DCV entry
The validation type used for this DCV entry
The email address for this DCV entry, required if 'type' is set to 'EMAIL'

POST /v2/ssl/certificates
Content-Type: application/json

{}