Retrieves information that describes the default organization through which you may validate your OV and EV certificates.
Retrieve information about the default organization through the following request:
HTTP Method | Request URI |
---|---|
GET |
https://api.vdms.io/sec/cps/v2.0/organizations/default |
This endpointIdentifies a request's connection point to our REST API service. only takes advantage of common request headers.
Unlike requests to api.edgecast.com, requests to our API gateway (api.vdms.io) require an access token (OAuth).
Request body parameters are not required by this endpoint.
The response to the above request includes an HTTP status code, response headers, and a response body.
A status code indicates whether the request was successfully performed.
The response for this endpoint only includes standard HTTP response headers.
The response body for a successful request (200 OK) contains the following response elements:
Name | Data Type | Description |
---|---|---|
Array of objects |
Contains additional contacts that are also responsible for validating certificates for this organization. |
|
city |
String |
Indicates the organization's city. |
company_address |
String |
Indicates the organization's address. |
company_address2 |
String |
Indicates the organization's secondary address information (e.g., suite number). |
company_name |
String |
Indicates the organization's name. |
contact_email |
String |
Indicates the email address for the individual responsible for validating certificates for this organization. |
contact_first_name |
String |
Indicates the first name for the individual responsible for validating certificates for this organization. |
contact_last_name |
String |
Indicates the last name for the individual responsible for validating certificates for this organization. |
contact_phone |
String |
Indicates the phone number for the individual responsible for validating certificates for this organization. |
contact_title |
String |
Indicates the title of the individual responsible for validating certificates for this organization. |
country |
String |
Indicates the organization's country by its ISO 3166 country code. Use the Get Country Codes endpoint to retrieve a list of countries and their codes. |
id |
Integer |
Returns a null value. |
organizational_unit |
String |
Indicates the name of the organizational unit responsible for validating certificates for this organization. |
state |
String |
Indicates the organization's state by its abbreviation. |
zip_code |
String |
Indicates the organization's zip code. |
The additional_contacts array describes each of the organization's additional contacts through the following properties:
Name | Data Type | Description |
---|---|---|
contact_type |
String |
Returns EVApprover |
|
String |
Indicates the email address for the current contact. |
first_name |
String |
Indicates the first name for the current contact. |
id |
Integer |
Reserved for future use. |
last_name |
String |
Indicates the last name for the current contact. |
phone |
String |
Indicates the phone number for the current contact. |
title |
String |
Indicates the title of the current contact. |
The response body for an unsuccessful request will contain an error response that provides additional information.
A sample JSON request is shown below.
GET https://api.vdms.io/sec/cps/v2.0/organizations/default HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: api.vdms.io
A sample JSON response is shown below.
HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Type: application/json; charset=utf-8
Date: Thu, 15 Apr 2021 12:00:00 GMT
Content-Length: 628
{ "id": null, "country": "US", "state": "CA", "zip_code": "90094", "city": "Los Angeles", "company_name": "Example, Inc.", "company_address": "123 Main St.", "company_address2": "", "organizational_unit": "IT", "contact_first_name": "System", "contact_last_name": "Admin", "contact_email": "info@example.com", "contact_phone": "+1(877)334-3236", "contact_title": null, "additional_contacts": [{ "first_name": "Richard", "last_name": "Smith", "email": "richard.smith@example.com", "phone": "+1(877)334-3236", "title": "", "contact_type": "EvApprover", "id": 0 } ] }