Skip to main content

Submit organization for validation

POST https://www.digicert.com/services/v2/organization/{{organization_id}}/validation

Use this endpoint to submit an organization to be validated and add verified contacts who can approve orders for the given product type.

Notice

To get a list of possible user IDs to use for the verified_users array, use the List approvers endpoint.

Example requests and responses

Request parameters

Notice

When adding an existing contact, use the id parameter in the request body and omit the first_name, last_name, job_title, telephone, and email parameters.

Name

Req/Opt

Type

Description

validations

required

array

List of validation types the organization will be validated for.

.. type

required

string

Validation type identifier.

Possible values:

  • ov: Normal Organization Validation

  • ev Extended Organization Validation

  • cs: Code Signing Organization Validation

  • ev_cs: Code Signing Organization Extended Validation

  • ds: Document Signing Validation

  • smime: SMIME Organization Validation

See also: Glossary – Validation types.

.. verified_users

conditional

array

List of verified contacts for the organization.

Required if the validation type is ev, cs, or ev_cs. Not used for other validation types.

.. .. id

conditional

int

ID of the user to add as the verified contact.

Only required if adding an existing user as the verified contact. If included, other contact parameters are ignored.

.. .. first_name

conditional

string

First name of the verified contact.

Required if the id parameter is omitted.

.. .. last_name

conditional

string

Last name of the verified contact.

Required if the id parameter is omitted.

.. .. job_title

conditional

string

Job title of the verified contact.

Required if the id parameter is omitted.

.. .. telephone

conditional

string

Telephone number of the verified contact.

Required if the id parameter is omitted.

.. .. email

conditional

string

Email address of the verified contact.

Required if the id parameter is omitted.