Get Default Organization

Retrieves information that describes the default organization through which you may validate your OV and EV certificates.

Request

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

Request Headers

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

Request body parameters are not required by this endpoint.

Response

The response to the above request includes an HTTP status code, response headers, and a response body.

Status Code

A status code indicates whether the request was successfully performed.

Response Headers

The response for this endpoint only includes standard HTTP response headers.

View common response headers.

Response Body

The response body for a successful request (200 OK) contains the following response elements:

Name Data Type Description

additional_contacts

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.

additional_contacts Array

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 for EV certificates.

email

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.

Errors

The response body for an unsuccessful request will contain an error response that provides additional information.

Sample Request and Response

A sample JSON request is shown below.

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
		}
	]
}