Knowledge Base

Enroll SSL Certificates via API

When you want to enroll an SSL certificate using the API. This article explains the required parameters, supported verification methods, CSR submission, and additional organization details required for certificate enrollment, including EV SSL certificates.

Enroll

Description

Enroll the certificate for the specified order id.

Parameters

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Authentication Parameter
api-key	String	Required	Authentication Parameter
order-id	Integer	Required	The order id for for the certificate.
csr	String	Required	CSR
verification-email	String	Optional	This is only required if the verification method is email.
verification-method	String	Optional	The type of verification method. Accepted values: email, cname, http. Default is email
dba	String	Optional	Doing Business As Note The value for this parameter cannot be changed later.
address	String	Optional	Address of the organization Note This parameter is compulsory in case of EV Certificate.
zip	String	Optional	Zip/Postal Code Note This parameter is compulsory in case of EV Certificate.
country-of-incorporation	String	Optional	2 letter country-code of the country in which the organization was incorporated Note This parameter is compulsory in case of EV Certificate. The value for this parameter cannot be changed later.
app-rep-email	String	Optional	Email address of the individual authorized to accept Agreements Note This parameter is compulsory in case of EV Certificate. The value for this parameter cannot be changed later.
joi-city	String	Conditional	NEW — required for EV from 18th June 2026
joi-state-or-province	String	Conditional	NEW — required for EV from 18th June 2026
main-phone	String	Conditional	NEW — required for EV from 18th June 2026
approver-title	String	Conditional	NEW — required for EV from 18th June 2026
approver-firstname	String	Conditional	NEW — required for EV from 18th June 2026
approver-lastname	String	Conditional	NEW — required for EV from 18th June 2026

HTTP Method

POST

Example Test URL Request

https://test.httpapi.com/api/sslcert/enroll.json?auth-userid=0&api-key=key&order-id=0&csr=-----BEGIN NEW CERTIFICATE REQUEST---MIIBwzCCASwCAQAwgYIxCzAJBgNVB-----END NEW CERTIFICATE REQUEST---&verification-email=test@yourdomain.com&verification-method=email

Response

Returns a hash map of the enrollment action.

Did you find this article helpful?