openapi: 3.0.3
info:
description: API Documentation
version: 2.0.0
title: DomainManager API
contact:
email: domain_api_support@cscglobal.com
servers:
- url: 'https://apis.cscglobal.com/dbs/api/v2'
description: Production
- url: 'https://apis-ote.cscglobal.com/dbs/api/v2'
description: Demo
security:
- ApiKey: []
BearerToken: []
tags:
- name: domains
description: View domain data and place domain orders
- name: zones
description: View zone data and submit zone changes
- name: events
description: View security events
- name: orders
description: View order data
- name: tls
description: View certificate data and place tls orders
- name: admin
description: View admin data
- name: dsrecords
description: 'View, add, and remove Delegation Signer records'
- name: token
description: View token actions
- name: urlf
description: View URL forwarding data and add or remove nodes
paths:
'/domains/{qualifiedDomainName}':
get:
tags:
- domains
summary: Get domain data by qualified domain name
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/domains/example.com -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.domains;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class DomainsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/domains/example.com");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/domains/example.com"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: qualifiedDomainName
description: Qualified domain name
required: true
schema:
type: string
example: example.com
responses:
'200':
description: domain found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/Domain'
application/xml:
schema:
$ref: '#/components/schemas/Domain'
'400':
description: malformed request
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Domain not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAIN_NOT_FOUND
description: Domain not found
value: example.com
/domains:
get:
tags:
- domains
summary: Get domain portfolio data
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/domains?filter=qualifiedDomainName=="example.com" -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.domains;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class DomainsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/domains?filter=qualifiedDomainName==example.com");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/domains?filter=qualifiedDomainName==\"example.com\""
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
description: |
Filters can be applied to your request to limit the type of data you receive.
### Selectors
Selectors can be used to filter by specific properties on the domain.
- accountName
- accountNumber
- brandName
- businessUnit
- city
- country
- countryCode
- criticalDomain
- dnssecActivated
- dnsType
- domain
- email
- extension
- fax
- firstName
- idnReferenceName
- lastModifiedDate
- lastModifiedDescription
- lastModifiedReason
- lastName
- localAgent
- managedStatus
- nameServers
- newGtld
- organization
- paidThroughDate
- phone
- phoneExtn
- postalCode
- qualifiedDomainName
- redirectType
- registrationDate
- registryExpiryDate
- serverDeleteProhibited
- serverTransferProhibited
- serverUpdateProhibited
- stateProvince
- street1
- street2
- urlForwarding
- whoisPrivacy
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Like query |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all domains with a qualifiedDomainName of example.com
```
qualifiedDomainName=="example.com"
```
Find all domains with a qualifiedDomainName like example
```
qualifiedDomainName=like="example\*"
```
Find all domains with a registrationDate greater than Jan 05 2010
```
registrationDate=gt="05-JAN-2010"
```
Find all domains with a nameserver of dns1.mydns.com and an extension of 'com'
```
nameservers=="dns1.mydns.com";extension=="com"
```
Find all domains with a nameserver of dns1.mydns.com or dns2.mydns.com
```
nameservers=in=("dns1.mydns.com","dns2.mydns.com")
```
Find all domains with a WHOIS contact first name of Tom OR a last name of Smith
```
firstName=="Tom",lastName=="Smith"&sort=qualifiedDomainName,asc
```
Find all domains by business unit name Foo & Bar (encoded)
```
businessUnit=="Foo%20%26%20Bar"
```
---
required: false
schema:
type: string
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/Size'
- $ref: '#/components/parameters/Sort'
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/PagedDomainResponse'
/domains/availability:
get:
tags:
- domains
summary: Check registration availability for one or more domain names
description: |
Code examples
CURL
```bash
curl -X GET "https://apis.cscglobal.com/dbs/api/v2/domains/availability?qualifiedDomainNames=example.com,test.com" -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.domains;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class DomainsAvailability {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/domains/availability?qualifiedDomainNames=example.com");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/domains/availability?qualifiedDomainNames=example.com,test.com"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: qualifiedDomainNames
description: 'Provide a maximum of 50 fully qualified domain names delimited by a comma (,)'
required: true
schema:
type: string
example: 'example.com,another-example.com'
responses:
'200':
description: availability check completed
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/RegistrationAvailabilityResult'
examples:
DomainAvailable:
$ref: '#/components/examples/DomainRegistrationAvailable'
Domain Not Available:
$ref: '#/components/examples/DomainRegistrationNotAvailable'
application/xml:
schema:
$ref: '#/components/schemas/RegistrationAvailabilityResult'
/domains/configuration:
get:
tags:
- domains
summary: Get domain configuration information for owned domains with optional filtering
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/domains/configuration?size=1&page=1 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.domains;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class DomainsConfiguration {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/domains/configuration?size=1&page=1");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/domains/configuration?size=1&page=1"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
description: |
Filters can be applied to your request to limit the type of data you receive.
### Selectors
Selectors can be used to filter by specific properties on the domain.
- domain
- domainLabel
- domainStatusCode
- dnsHostingType
- extension
- tld
- country
- adminEmail
- adminName
- adminOrg
- regEmail
- regName
- regOrg
- techEmail
- techName
- techOrg
- accountNumber
- accountName
- businessUnit
- dnsTraffic12moAve
- hasCscUrlf
- hasDkim
- hasDnssecDs
- hasSpf
- hasWww
- isGtld
- isLive
- isLiveType
- isMultilockEligible
- isVital
- multiLocked
- numLiveMx
- numRootA
- numRootTxt
- numSslNetcraft
- numWwwA
- numWwwCname
- registryExpiryDate
- rootHttpCode
- rootHttpUrl
- rootIsUrlf
- serverDeleteProhibited
- serverTransferProhibited
- serverUpdateProhibited
- urlfTraffic12moAve
- valueRootA
- valueRootMx
- valueRootTxt
- valueWwwA
- valueWwwCname
- wwwHttpCode
- wwwHttpUrl
- wwwIsUrlf
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Like query |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find configuration for the domain example.com
```
domain=="example.com"
```
Find all domains with a domainLabel like example
```
domainLabel=like="example*"
```
Find all domains with a registryExpiryDate greater than Jan 05 2020
```
registryExpiryDate=gt="2020-01-05"
```
Find all domains with an accountNumber of 1234567 or 0987654
```
accountNumber=in=(1234567, 0987654)
```
Find all domains with a valueRootA of 165.160.13.20 or 165.160.15.25 and an extension of 'com'
```
valueRootA=in=("165.160.13.20", "165.160.15.25");extension=="com"
```
Find all domains where isVital is true and either multiLocked is false or isMultilockEligible is false
```
isVital==true;multiLocked==false,isMultilockEligible==false
```
---
required: false
schema:
type: string
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/Size'
responses:
'200':
description: Domain Configuration Call Successful
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ConfigurationCallSuccess'
application/xml:
schema:
$ref: '#/components/schemas/ConfigurationCallSuccess'
/domains/registration:
post:
tags:
- domains
summary: Place a domain registration order
description: |
Code examples
CURL
```bash
curl -X POST https://apis.cscglobal.com/dbs/api/v2/domains/registration -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.domains;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class DomainsReg {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/domains/registration");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("POST");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/domains/registration"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: 'The details required to register a domain. **If an order template is available for the account mapped to the bearer token, then only the "qualifiedDomainName" property is required.**'
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RegistrationRequest'
application/xml:
schema:
$ref: '#/components/schemas/RegistrationRequest'
responses:
'201':
description: Registration submission success
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/RegistrationRequestResult'
application/xml:
schema:
$ref: '#/components/schemas/RegistrationRequestResult'
'202':
description: 'Order is submitted, but incomplete'
'400':
description: Malformed request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: INVALID_DNS_TYPE
description: DNS type is invalid. Please provide a valid DNS type.
value: CSC_SUPER_BASIC
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/domains/nsmodification:
put:
tags:
- domains
summary: Place a NS modification order
description: |
Code examples
CURL
```bash
curl -X PUT https://apis.cscglobal.com/dbs/api/v2/domains/nsmodification -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.domains;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class DomainsNSMod {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/domains/nsmodification");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("PUT");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/domains/nsmodification"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.put(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: The details required to perform a NS modification.
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/NsModRequest'
responses:
'200':
description: Modification submission success
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/NsModRequestResult'
'400':
description: Malformed request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: PREMIUM_DNS_CANNOT_BE_MODIFIED
description: Please contact your system administrator to change your DNS.
value: cscdbs-10042020-premium-child2-01.com
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Domain not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAIN_NOT_FOUND
description: Domain not found
value: cscdbs-test-domain-10042020-lapse.com
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/domains/whoiscontactmodification:
put:
tags:
- domains
summary: Place a Whois contact modification order
description: |
Code examples
CURL
```bash
curl -X PUT https://apis.cscglobal.com/dbs/api/v2/domains/whoiscontactmodification -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.domains;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class DomainsWhoisMod {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/domains/whoiscontactmodification");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("PUT");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/domains/whoiscontactmodification"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.put(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: The details required to perform a Whois Contact Modification.
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WhoisContactModRequest'
responses:
'201':
description: Modification submission success for Whois Contact Modification
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/WhoisContactModRequestResult'
'202':
description: Modification submission success for Whois Contact Modification
content:
application/json;charset=UTF-8:
schema:
type: object
properties:
result:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
status:
type: object
properties:
code:
$ref: '#/components/schemas/nsModResultCode'
message:
type: string
example: Order has been successfully submitted
description: A message that corresponds with the response status code
additionalInformation:
type: string
example: Additional registry-specific information is required. Your service representative will contact you to complete this order.
description: Any further details/data that is needed for the response
uuid:
type: string
example: 113b4cef-9b4d-4962-9a4e-f3186a7d12ed
price:
type: object
properties:
currency:
type: string
example: USD
total:
type: number
example: 20
linePrices:
type: array
items:
$ref: '#/components/schemas/linePricesWhoisContactMod'
'400':
description: Bad request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_CHANGE_FOUND
description: No Contact Profiles are changing
value: 'Admin, Technical, or Registrant are not changing'
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token not provided
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: INVALID_ACCESS
description: You do not have access to update this domain
value: ''
'404':
description: Domain not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAIN_NOT_FOUND
description: Domain not found.
value: cscdbs-test-domain-10042020-lapse.com
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ''
description: An unexpected error occurred...
value: ''
'/zones/{zoneName}':
get:
tags:
- zones
summary: Get zone data by qualified zone name
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/zones/example.com -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.zones;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class ZonesGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/zones/example.com");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/zones/example.com"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: zoneName
description: Zone name
required: true
schema:
type: string
example: example.com
- in: query
name: filter
required: false
schema:
type: string
example: 'priority=in=("10","20")'
description: |
Filters can be applied to your request to limit the zone records returned.
### Selectors
Selectors can be used to filter by specific properties on the zone resource records.
- flag
- key
- port
- priority
- recordType
- tag
- ttl
- value
- weight
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Like query |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all resource records with a recordType of A
```
recordType=="A"
```
Find all resource records with a key of "@" and a value like "165.160.*"
```
key="@";value=like="165.160.*"
```
Find all resource records with an 'A' record with a value of 1.2.3.4
```
(recordType=="a";value=="1.2.3.4")
```
Find all resource records that have a '10' or '20' priority
```
priority=in=("10","20")
```
Find all resource records with an 'A' record with a key of 'www' OR a 'CNAME' record with a value of 'www'
```
(recordType=="a";key=="www"),(recordType=="cname";value=="www")
```
---
responses:
'200':
description: zone found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/Zone'
application/xml:
schema:
$ref: '#/components/schemas/Zone'
'400':
description: malformed request
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
'404':
description: Domain not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAIN_NOT_FOUND
description: Domain not found
value: example.com
/zones:
get:
tags:
- zones
summary: Get zone portfolio data
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/zones?filter=fullDomainName=="example.com" -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.zones;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class ZonesGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/zones?filter=fullDomainName==\"example.com\"");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/zones?filter=fullDomainName==\"example.com\""
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
required: false
schema:
type: string
example: 'priority=in=("10","20")'
description: |
Filters can be applied to your request to limit the type of data you receive.
### Selectors
Selectors can be used to filter by specific properties on the zone or zone resource records.
- expire
- flag
- fullDomainName
- id
- key
- masterHost
- port
- priority
- recordType
- refresh
- retry
- serial
- tag
- techEmail
- ttl
- ttlMin
- ttlNeg
- ttlZone
- value
- weight
- zoneId
- zoneName
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Like query |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all zones with a zoneName of example.com
```
zoneName=="example.com"
```
Find all zones with a zoneName like example
```
zoneName=like="\*example\*"
```
Find all zones with a ttlNeg less than 15000
```
ttlNeg=lt="15000"
```
Find all zones with an 'A' record with a value of 1.2.3.4
```
(recordType=="a";value=="1.2.3.4")
```
Find all zones that have a resource record with a '10' or '20' priority
```
priority=in=("10","20")
```
Find all zones with an 'A' record with a key of 'www' OR a 'CNAME' record with a value of 'www'
```
(recordType=="a";key=="www"),(recordType=="cname";value=="www")
```
---
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/Size'
- $ref: '#/components/parameters/Sort'
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/PagedZoneResponse'
/zones/edits:
get:
tags:
- zones
summary: Get one or more zone edits
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/zones/edits?filter=zoneName=="example.com" -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.zones;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class ZonesEditsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/zones/edits?filter=zoneName==\"example.com\"");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/zones/edits?filter=zoneName==\"example.com\""
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
required: false
schema:
type: string
example: zoneName=="example.com"
description: |
Filters can be applied to your request to limit the type of data you receive.
### Selectors
Selectors can be used to filter by specific properties on the zone or zone edit.
- zoneName
- modifiedDate
- status
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Like query |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all zone edits for the zone of example.com
```
zoneName=="example.com"
```
Find all zone edits for a zone with a name like example
```
zoneName=like="\*example\*"
```
Find all zone edits with a modified date of March 31st, 2020
```
modifiedDate==31-Mar-2020
```
Find all zone edits with a modified date before March 31st, 2020 and with a status of 'CANCELED'
```
modifiedDate=lt=31-Mar-2020;status==canceled
```
---
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/ZoneEditSize'
- $ref: '#/components/parameters/Sort'
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/PagedZoneEditResponse'
post:
tags:
- zones
summary: Submit and publish one or more zone edits
description: |
Code examples
CURL
```bash
curl -X POST https://apis.cscglobal.com/dbs/api/v2/zones/edits -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.zones;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class ZonesEditsPublish {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/zones/edits");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("POST");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/zones/edits"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: |
The details required to publish a zone edit. The record fields (KEY, TTL, TAG, etc.) are dependent on record type.
For current record fields, use the prefix *'current'* (ex. currentTag), and for new record fields,
use the prefix *'new'* (ex. newTag).
**For SOA records only the EDIT action is applicable. Since SOA records do not have a key or a value field, only new values need to be provided.**
**Since it is possible for CAA records to have duplicate 'key' and 'value' fields, for any action other than 'ADD' please provide the current 'tag' value as well.**
| **Action** | **Zone Name** | **Record Type** | **Current Values** | **New Values** |
| ---------- | ------------- | --------------- | ------------------ | -------------- |
| ADD | Y | Y | N | Y |
| EDIT | Y | Y | value and key | Y |
| PURGE | Y | Y | value and key | N |
| ACTIVATE | Y | Y | value and key | N |
| DEACTIVATE | Y | Y | value and key | N |
---
required: true
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ZoneEditRequest'
application/xml:
schema:
$ref: '#/components/schemas/ZoneEditRequest'
responses:
'201':
description: The zone edit was created and submitted for publishing
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ZoneEditRequestResult'
application/xml:
schema:
$ref: '#/components/schemas/ZoneEditRequestResult'
'400':
description: Malformed request. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: LHS_LABEL_NOT_IN_ZONE
description: 'The left-hand side must be in-zone. If it ends with a ''.'', it must end with ''.'''
value: 'edits[0]'
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: RESOURCE_RECORD_NOT_FOUND
description: Requested zone resource record not found
value: 'key=*, value=1.255.255.255, zoneName=api2-testing-post-zoneedits.com, type=A'
'500':
description: Internal Server Error. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
'/zones/edits/status/{editID}':
get:
tags:
- zones
summary: Get the current status of a zone edit
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/zones/edits/status/1234 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.zones;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class ZonesEditStatusGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/zones/edits/status/1234");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/zones/edits/status/1234"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: editID
description: Zone Edit ID
required: true
schema:
type: string
example: 5eb7ad20-0f90-4a31-b91b-a66ef6033b37
responses:
'200':
description: Zone edit status found. **A link to cancel the edit is returned *only* if the edit is on 'FAILED' status**
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ZoneEditStatusResult'
'400':
description: Malformed request. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ZONE_EDIT_ID_REQUIRED
description: Zone edit id is a required path variable
value: ''
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ZONE_EDIT_NOT_FOUND
description: Requested zone edit not found
value: 1234
'500':
description: Internal Server Error. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
'/zones/edits/{editID}':
get:
tags:
- zones
summary: Get a single zone edit by its UUID
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/zones/edits/1234 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.zones;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class ZonesEditsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/zones/edits/1234");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/zones/edits/1234"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: editID
description: A zone edit's UUID
required: true
schema:
type: string
example: 877c37aa-60ac-4d92-a5a4-0da64a4b3e38
responses:
'200':
description: zone edit found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ZoneEdit'
application/xml:
schema:
$ref: '#/components/schemas/ZoneEdit'
'400':
description: malformed request
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: BAD_ID
description: The ID entered has an invalid format
value: bad ID
'404':
description: zone edit not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ZONE_EDIT_NOT_FOUND
description: Requested zone edit not found
value: 877c37aa-60ac-4d92-a5a4-0da64a4b3e38
delete:
tags:
- zones
summary: Cancel a zone edit with a 'FAILED' status
description: |
Code examples
CURL
```bash
curl -X DELETE https://apis.cscglobal.com/dbs/api/v2/zones/edits/1234 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.zones;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class ZonesEditsDelete {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/zones/edits/1234");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("DELETE");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/zones/edits/1234"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.delete(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: editID
description: Zone Edit ID
required: true
schema:
type: string
example: 5eb7ad20-0f90-4a31-b91b-a66ef6033b37
responses:
'204':
description: The zone edit was cancelled successfully
'400':
description: Malformed request. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ZONE_EDIT_ID_REQUIRED
description: Zone edit id is a required path variable
value: ''
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ZONE_EDIT_NOT_FOUND
description: Requested zone edit not found
value: '1234'
'500':
description: Internal Server Error. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
'/events/{eventID}':
get:
tags:
- events
summary: Get security events by ID
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/events/1234 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.events;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class EventsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/events/1234");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/events/1234"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: eventID
description: Event ID
required: true
schema:
type: string
example: 6eb7ad20-0f90-4a31-b91b-a66ef6033b37
responses:
'200':
description: security event found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/SecurityEvent'
'401':
description: invalid bearer token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: ''
'404':
description: security event not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: EVENT_NOT_FOUND
description: Requested event not found
value: 6eb7ad20f-0f99-4ea31-b81b-a66ef603d3b37
/events:
get:
tags:
- events
summary: Get one or more security events
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/events?filter=eventType==DNS_CHANGE_REQUESTED -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.events;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class EventsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/events?filter=eventType==DNS_CHANGE_REQUESTED");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/events?filter=eventType==DNS_CHANGE_REQUESTED"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
required: false
schema:
type: string
example: 'eventDate=ge=2019-09-25T00:01:53'
description: |
Filters can be applied to your request to limit the type of data you receive.
### Selectors
Selectors can be used to filter by specific properties on the security event.
- eventDate
- eventType
- id
---
### Event Date
If the 'event date' selector is provided it must be an ISO-standard timestamp. (ex. 2019-11-17T22:35:32). The timezone needs to be UTC for accurate results.
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all events of type DNS_CHANGE_REQUESTED
```
eventType==DNS_CHANGE_REQUESTED
```
Find all events between two timestamps
```
eventdate=le=2019-09-25T00:00:00;eventDate=ge=2019-07-04T00:00:00
```
Find all LOGIN events that occurred after August 25, 2019
```
eventdate=gt=2019-08-25T00:00:00;eventType==LOGIN
```
---
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/Size'
- $ref: '#/components/parameters/Sort'
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/PagedEventResponse'
'/orderstatus/{orderUUID}':
get:
tags:
- orders
summary: Get orders by their UUID
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/orderstatus/1234 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.orders;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class OrderStatusGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/orderstatus/1234");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/orderstatus/1234"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: orderUUID
description: The UUID of the order. Returned as 'uuid' in the response.
required: true
schema:
type: string
example: 6eb7ad20-0f90-4a31-b91b-a66ef6033b37
responses:
'200':
description: Order found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/Order'
'401':
description: Invalid bearer token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: ''
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: order not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ORDER_NOT_FOUND
description: Requested order not found
value: 6eb7ad20f-0f99-4ea31-b81b-a66ef603d3b37
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/orderstatus:
get:
tags:
- orders
summary: Get one or more orders
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/orderstatus?filter=orderType==MULTILOCK -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.orders;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class OrderStatusGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/orderstatus?filter=orderType==MULTILOCK");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/orderstatus?filter=orderType==MULTILOCK"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
required: false
schema:
type: string
example: orderType==REGISTRATION;raisedDate=ge=2019/12/06
description: |
Filters can be applied to your request to limit the type of data that you receive.
### Selectors
Selectors can be used to filter by specific properties on the order.
- orderType
- qualifiedDomainName
- raisedDate
- uuid
---
### Raised Date
The 'raised date' selector must have the following format:
yyyy/MM/dd
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Like Query |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all orders of type MULTILOCK
```
orderType==MULTILOCK
```
Find all orders between two dates
```
raisedDate=le=2019/09/25;raisedDate=ge=2019/07/04
```
Find all REGISTRATION orders that were raised after August 25, 2019
```
raisedDate=gt=2019/08/25;orderType==REGISTRATION
```
---
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/MultiOrderResponse'
'400':
description: Malformed request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: SEARCH_MAX_LIMIT_REACHED
description: Order search is limited to 500 domains per search
value: orderType==REG;raisedDate=le=2019/12/10;raisedDate=ge=2019/12/06
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/tls/registration:
post:
tags:
- tls
summary: Place a TLS registration order
description: |
Code examples
CURL
```bash
curl -X POST https://apis.cscglobal.com/dbs/api/v2/tls/registration -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.tls;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class TLSRegistration {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/tls/registration");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("POST");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/tls/registration"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: |
The details required to perform a TLS registration.
**In the request please provide the value corresponding to your certificate and/or software type.**
| **certificateType** | **Value** |
| ---------- | ------------- |
| CSC TrustedSecure Premium Certificate | 0 |
| CSC TrustedSecure Premium Wildcard Certificate | 1 |
| CSC TrustedSecure UC Certificate | 2 |
| CSC TrustedSecure EV Certificate | 3 |
| CSC Trusted Secure Domain Validated SSL | 4 |
| CSC Trusted Secure Domain Validated Wildcard SSL | 5 |
| CSC Trusted Secure Domain Validated UC | 6 |
| **ServerSoftware** | **Value** |
| ---------- |---------------|
| OTHER | -1|
| APACHE_MODSSL | 2 |
| APACHE_SSL | 3 |
| C2NET_STRONGHOLD | 4 |
| CISCO_3000_SERIES_VPN_CONCENTRATOR | 33 |
| CITRIX | 34 |
| COBALT_RAQ | 5 |
| COVALENT_SERVER_SOFTWARE | 6 |
| ENSIM | 29 |
| H_SPHERE | 32 |
| IBM_HTTP_SERVER | 7 |
| IBM_INTERNET_CONNECTION_SERVER | 8 |
| IPLANET | 9 |
| JAVA_WEBSERVER_JAVASOFT_SUN | 10 |
| LOTUS_DOMAINO_GO | 12 |
| MICROSOFT_IIS_1X_TO_4X | 13 |
| MICROSOFT_IIS_5X_TO_6X | 14 |
| MICROSOFT_IIS_7X_TO_LATER | 35 |
| NETSCAPE_ENTERPRISE_SERVER | 15 |
| NETSCAPE_FASTTRACK | 16 |
| NGINX | 36 |
| NOVELL_WEB_SERVER | 17 |
| ORACLE | 18 |
| PLESK | 30 |
| QUID_PRO_QUO | 19 |
| R3_SSL_SERVER | 20 |
| RAVEN_SSL | 21 |
| REDHAT_LINUX | 22 |
| SAP_WEB_APPLICATION_SERVER | 23 |
| TOMCAT | 24 |
| WEBSITE_PROFESSIONAL | 25 |
| WEBSTAR_4X_AND_LATER | 26 |
| WEBTEN_FROM_TENON | 27 |
| WHM_CPANEL | 31 |
| ZEUS_WEB_SERVER | 28 |
---
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TlsRegistrationRequest'
application/xml:
schema:
$ref: '#/components/schemas/TlsRegistrationRequest'
responses:
'200':
description: TLS Registration submission success
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/TlsResponse'
application/xml:
schema:
$ref: '#/components/schemas/TlsResponse'
'400':
description: Malformed request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: CERTIFICATE_NOT_SUPPORTED
description: Invalid certificate type. Please provide a valid certificate type. Refer to the documentation for valid values.
value: 100
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/tls/renewal:
post:
tags:
- tls
summary: Place a TLS renewal order
description: |
Code examples
CURL
```bash
curl -X POST https://apis.cscglobal.com/dbs/api/v2/tls/renewal -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.tls;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class TLSRenewalOrder {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/tls/renewal");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("POST");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/tls/renewal"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: |
The details required to perform a TLS renewal.
**In the request please provide the value corresponding to your software type.**
| **ServerSoftware** | **Value** |
| ---------- |---------------|
| OTHER | -1|
| APACHE_MODSSL | 2 |
| APACHE_SSL | 3 |
| C2NET_STRONGHOLD | 4 |
| CISCO_3000_SERIES_VPN_CONCENTRATOR | 33 |
| CITRIX | 34 |
| COBALT_RAQ | 5 |
| COVALENT_SERVER_SOFTWARE | 6 |
| ENSIM | 29 |
| H_SPHERE | 32 |
| IBM_HTTP_SERVER | 7 |
| IBM_INTERNET_CONNECTION_SERVER | 8 |
| IPLANET | 9 |
| JAVA_WEBSERVER_JAVASOFT_SUN | 10 |
| LOTUS_DOMAINO_GO | 12 |
| MICROSOFT_IIS_1X_TO_4X | 13 |
| MICROSOFT_IIS_5X_TO_6X | 14 |
| MICROSOFT_IIS_7X_TO_LATER | 35 |
| NETSCAPE_ENTERPRISE_SERVER | 15 |
| NETSCAPE_FASTTRACK | 16 |
| NGINX | 36 |
| NOVELL_WEB_SERVER | 17 |
| ORACLE | 18 |
| PLESK | 30 |
| QUID_PRO_QUO | 19 |
| R3_SSL_SERVER | 20 |
| RAVEN_SSL | 21 |
| REDHAT_LINUX | 22 |
| SAP_WEB_APPLICATION_SERVER | 23 |
| TOMCAT | 24 |
| WEBSITE_PROFESSIONAL | 25 |
| WEBSTAR_4X_AND_LATER | 26 |
| WEBTEN_FROM_TENON | 27 |
| WHM_CPANEL | 31 |
| ZEUS_WEB_SERVER | 28 |
---
required: true
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/TLSRenewalRequest'
application/xml:
schema:
$ref: '#/components/schemas/TLSRenewalRequest'
responses:
'200':
description: TLS renewal submission success
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/TlsResponseUCC'
application/xml:
schema:
$ref: '#/components/schemas/TlsResponseUCC'
'400':
description: Malformed request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: INVALID_SERVER_SOFTWARE
description: Server software is mandatory. Please provide a valid server software. Refer to the documentation for valid values.
value: 100
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: order not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ORDER_NOT_FOUND
description: Requested order not found
value: 6eb7ad20f-0f99-4ea31-b81b-a66ef603d3b37
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/tls/reissue:
post:
tags:
- tls
summary: Place a TLS reissue order
description: |
Code examples
CURL
```bash
curl -X POST https://apis.cscglobal.com/dbs/api/v2/tls/reissue -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.tls;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class TLSReissueOrder {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/tls/reissue");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("POST");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/tls/reissue"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: |
The details required to perform a TLS reissue.
**In the request please provide the value corresponding to your software type.**
| **ServerSoftware** | **Value** |
| ---------- |---------------|
| OTHER | -1|
| APACHE_MODSSL | 2 |
| APACHE_SSL | 3 |
| C2NET_STRONGHOLD | 4 |
| CISCO_3000_SERIES_VPN_CONCENTRATOR | 33 |
| CITRIX | 34 |
| COBALT_RAQ | 5 |
| COVALENT_SERVER_SOFTWARE | 6 |
| ENSIM | 29 |
| H_SPHERE | 32 |
| IBM_HTTP_SERVER | 7 |
| IBM_INTERNET_CONNECTION_SERVER | 8 |
| IPLANET | 9 |
| JAVA_WEBSERVER_JAVASOFT_SUN | 10 |
| LOTUS_DOMAINO_GO | 12 |
| MICROSOFT_IIS_1X_TO_4X | 13 |
| MICROSOFT_IIS_5X_TO_6X | 14 |
| MICROSOFT_IIS_7X_TO_LATER | 35 |
| NETSCAPE_ENTERPRISE_SERVER | 15 |
| NETSCAPE_FASTTRACK | 16 |
| NGINX | 36 |
| NOVELL_WEB_SERVER | 17 |
| ORACLE | 18 |
| PLESK | 30 |
| QUID_PRO_QUO | 19 |
| R3_SSL_SERVER | 20 |
| RAVEN_SSL | 21 |
| REDHAT_LINUX | 22 |
| SAP_WEB_APPLICATION_SERVER | 23 |
| TOMCAT | 24 |
| WEBSITE_PROFESSIONAL | 25 |
| WEBSTAR_4X_AND_LATER | 26 |
| WEBTEN_FROM_TENON | 27 |
| WHM_CPANEL | 31 |
| ZEUS_WEB_SERVER | 28 |
---
required: true
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/TLSReissueRequest'
application/xml:
schema:
$ref: '#/components/schemas/TLSReissueRequest'
responses:
'200':
description: TLS reissue submission success
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/TlsResponseEV'
application/xml:
schema:
$ref: '#/components/schemas/TlsResponseEV'
'400':
description: Malformed request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: INVALID_SERVER_SOFTWARE
description: Server software is mandatory. Please provide a valid server software. Refer to the documentation for valid values.
value: 100
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: order not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ORDER_NOT_FOUND
description: Requested order not found
value: 6eb7ad20f-0f99-4ea31-b81b-a66ef603d3b37
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
'/tls/certificate/{uuid}':
get:
tags:
- tls
summary: Get certificate by UUID
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/tls/certificate/1234 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.tls;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class TLSCertificateGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/tls/certificate/1234");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/tls/certificate/1234"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: uuid
description: The UUID of the order. Returned as 'uuid' in the response.
required: true
schema:
type: string
example: 6eb7ad20-0f90-4a31-b91b-a66ef6033b37
responses:
'200':
description: Certificate found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/TlsOrderResponse'
'401':
description: Invalid bearer token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: ''
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: order not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ORDER_NOT_FOUND
description: No Requested order not found found
value: 6eb7ad20f-0f99-4ea31-b81b-a66ef603d3b37
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/tls/certificate:
get:
tags:
- tls
summary: Get one or more certificates
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/tls/certificate?filter=status==ACTIVE -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.tls;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class TLSCertificateGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/tls/certificate?filter=status==ACTIVE");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/tls/certificate?filter=status==ACTIVE"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
required: false
schema:
type: string
example: certificateTypeId==2;name==cscdbs-test-domain-14072020-3.com;expirationDate==2020/07/24;effectiveDate==2020/07/24;status==ACTIVE;uuid==fa74d47c-87f6-48dc-bcd8-4acc9242cdb1
description: |
Filters can be applied to your request to limit the type of data that you receive. When filter is not given the API will fetch certificates with status (ACTIVE, PENDING, IMPORTED) for the accessible business units.
### Selectors
Selectors can be used to filter by specific properties on the security event.
- certificateTypeId
- name
- expirationDate
- effectiveDate
- status
- uuid
- accountNumber
- accountName
---
### ExpirationDate, EffectiveDate
The 'expirationDate' and the 'effectiveDate' selectors must have the following format:
yyyy/MM/dd
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Like Query |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all certificates with status ACTIVE
```
status==ACTIVE
```
Find all certificates between two dates
```
expirationDate=le=2019/09/25;expirationDate=ge=2019/07/04
```
Find all certificate orders that have expiry date after August 25, 2019
```
expirationDate=gt=2019/08/25;status==ACTIVE
```
---
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/MultiTlsRetrieveResponse'
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
'/tls/revoke/{uuid}':
put:
tags:
- tls
summary: Revoke certificate by UUID
description: |
Code examples
CURL
```bash
curl -X PUT https://apis.cscglobal.com/dbs/api/v2/tls/revoke/1234 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.tls;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class TLSRevokeCertificate {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/tls/revoke/1234");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("PUT");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/tls/revoke/1234"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.put(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: uuid
description: The UUID of the tls order. Returned as 'uuid' in the response.
required: true
schema:
type: string
example: 6eb7ad20-0f90-4a31-b91b-a66ef6033b37
responses:
'200':
description: Certificate revoked
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/RevokeTlsOrderResponse'
'401':
description: Invalid bearer token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: ''
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Order not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ORDER_NOT_FOUND
description: Order not found
value: ''
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/tls/cname:
post:
tags:
- tls
summary: CNAME record generation
description: |
Code examples
CURL
```bash
curl -X POST https://apis.cscglobal.com/dbs/api/v2/tls/cname -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.tls;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class TLSGenerateCname {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/tls/cname");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("POST");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/tls/cname"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: The details required to generate a CNAME record.
required: true
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/TLSCnameRequest'
application/xml:
schema:
$ref: '#/components/schemas/TLSCnameRequest'
responses:
'200':
description: TLS CNAME record generation submission success
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/TlsCnameResponse'
application/xml:
schema:
$ref: '#/components/schemas/TlsCnameResponse'
'400':
description: Malformed request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: INVALID_CSR
description: 'Invalid CSR, Please provide a valid CSR with the correct common name.'
value: '--- CSR CERTIFICATE VALUE ---'
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ERROR
description: An unexpected error occurred...
value: ''
/tls/orgcontacts:
get:
tags:
- tls
summary: Get one or more SSL contacts
description: |
Code Examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/tls/orgcontacts?filter=firstName==pat -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.tls;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class TLSContactsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/tls/orgcontacts?filter=lastName==smith");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/tls/orgcontacts"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- $ref: '#/components/parameters/SortOrgContacts'
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/Size'
- $ref: '#/components/parameters/FilterOrgContacts'
responses:
'200':
description: Successful
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/PagedSSLOrgContactResponse'
'400':
description: Malformed request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: INVALID_KEYWORD
description: API bearer token invalid
value: 'Invalid keyword. Valid keywords are: sort, filter, size, page'
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer token invalid
value: ''
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: null
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: INTERNAL_SERVER_ERROR
description: Internal server error occurred
value: ''
'/admin/businessunits/{businessUnitName}':
get:
tags:
- admin
summary: Get business unit data by business unit name
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/admin/businessunits/TEST%20BU -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.admin;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class BusinessUnitsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/admin/businessunits/TEST%20BU");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/admin/businessunits/TEST BU"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: businessUnitName
description: Business unit name
required: true
schema:
type: string
example: TEST BU
responses:
'200':
description: business unit found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/BusinessUnit'
application/xml:
schema:
$ref: '#/components/schemas/BusinessUnit'
'400':
description: malformed request
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Business unit not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: BUSINESS_UNIT_NOT_FOUND
description: Business unit not found
value: TEST
'500':
$ref: '#/components/responses/InternalServerError'
/admin/businessunits:
get:
tags:
- admin
summary: Get business unit data
description: |
Code examples
CURL
```bash
curl -X GET "https://apis.cscglobal.com/dbs/api/v2/admin/businessunits?filter=businessUnitName==%22TEST%20BU%22" -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.admin;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class BusinessUnitsGet {
public static void main(String[] args) throws IOException {
# search for business unit named "TEST BU" using URL encoding.
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/admin/businessunits?filter=businessUnitName==%22TEST%20BU%22");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/admin/businessunits?filter=businessUnitName==\"TEST BU\""
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
description: |
Filters can be applied to your request to limit the type of data you receive.
### Selectors
Selectors can be used to filter by specific properties on the business unit.
- accountName
- accountNumber
- businessUnitName
- usage
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Like query |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all business units with a businessUnitName of TEST BU
```
businessUnitName=="TEST BU"
```
Find all business units with a businessUnitName like TEST
```
businessUnitName=like="TEST*"
```
Find all business units with a usage of DOMAIN and an accountNumber of 123456
```
usage=="DOMAIN";accountNumber=="123456"
```
Find all business units with a usage of DOMAIN or RELATED_SERVICES
```
usage=in=("DOMAIN","RELATED_SERVICES")
```
---
required: false
schema:
type: string
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/Size'
- $ref: '#/components/parameters/Sort'
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/PagedBusinessUnitResponse'
'/admin/businessunit/{businessUnitName}/domain/{qualifiedDomainName}':
put:
tags:
- admin
summary: Modify the business unit associated with a domain
description: |
Code examples
CURL
```bash
curl -X PUT https://apis.cscglobal.com/dbs/api/v2/admin/businessunit/TEST%20BU/domain/example.com -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.admin;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class AdminModBusinessUnit {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/admin/businessunit/TEST%20BU/domain/example.com");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("PUT");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/admin/businessunit/TEST BU/domain/example.com"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.put(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: businessUnitName
description: New business unit name to associate with the domain
required: true
schema:
type: string
example: TEST BU
- in: path
name: qualifiedDomainName
description: Fully qualified domain name
required: true
schema:
type: string
example: example.com
responses:
'200':
description: business unit updated
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/businessUnitModResult'
'400':
description: ''
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
NO_CHANGE_FOUND:
summary: Business unit already set
value:
code: NO_CHANGE_FOUND
description: Business unit is not changing
value: TEST BU
NO_DOMAIN_USAGE:
summary: Business unit does not have domain usage
value:
code: NO_DOMAIN_USAGE
description: Business unit does not have domain usage
value: TEST BU
OPEN_ORDER_IN_PROGRESS:
summary: An open order is in progress
value:
code: OPEN_ORDER_IN_PROGRESS
description: Open order in progress
value: example.com
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: ''
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
BUSINESS_UNIT_NOT_FOUND:
summary: Business unit not found
value:
code: BUSINESS_UNIT_NOT_FOUND
description: Business unit not found
value: TEST BU
DOMAIN_NOT_FOUND:
summary: Domain not found
value:
code: DOMAIN_NOT_FOUND
description: Domain not found
value: example.com
/admin/customfields:
get:
tags:
- admin
summary: Get custom fields for this account
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/admin/customfields -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.admin;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class CustomFieldsGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/admin/customfields");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/admin/customfields"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- $ref: '#/components/parameters/Sort'
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/AccountCustomFields'
application/xml:
schema:
$ref: '#/components/schemas/AccountCustomFields'
'400':
description: malformed request
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
'401':
$ref: '#/components/responses/Unauthorized'
put:
tags:
- admin
summary: Modify the custom fields associated with a domain
description: |
Code examples
CURL
```bash
curl -X PUT https://apis.cscglobal.com/dbs/api/v2/admin/customfields -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Content-Type: application/json" -d @myRequest.txt"
```
Java
```java
package com.cscglobal.admin;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class CustomFieldsMod {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/admin/customfields");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("PUT");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/admin/customfields"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.put(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: The details required to modify custom fields on a domain
required: true
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/customFieldModRequest'
responses:
'200':
description: Custom field(s) updated
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/customFieldModResult'
'400':
description: ''
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
DUPLICATE_CUSTOM_FIELDS:
summary: Duplicate custom field found in request
value:
code: DUPLICATE_CUSTOM_FIELDS
description: Duplicate fields in request
value: TEST NAME
FIELD_VALUE_TOO_LONG:
summary: Length of value field too long
value:
code: FIELD_VALUE_TOO_LONG
description: Custom field value too long
value: A long value string
INVALID_CUSTOM_FIELD_VALUE:
summary: An undefined list selection was given
value:
code: INVALID_CUSTOM_FIELD_VALUE
description: Invalid value for custom field
value: Invalid value
MISSING_CUSTOM_FIELDS:
summary: Custom fields are required in request
value:
code: MISSING_CUSTOM_FIELDS
description: Custom fields are required
value: ''
UNAVAILABLE_CUSTOM_FIELD:
summary: Custom field not defined for this customer
value:
code: UNAVAILABLE_CUSTOM_FIELD
description: Custom field not defined for this customer
value: Undefined name
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Domain not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAIN_NOT_FOUND
description: Domain not found
value: example.com
/admin/whoiscontactprofiles:
get:
tags:
- admin
summary: Get Whois contact profile data
description: |
Code examples
CURL
```bash
curl -X GET "https://apis.cscglobal.com/dbs/api/v2/admin/whoiscontactprofiles?filter=profileName==%22Example%20Name%22" -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.admin;
import java.io.IOException;
import java.net.URL;
import java.net.HttpURLConnection;
public class WhoisContactProfilesGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/admin/whoiscontactprofiles?filter=profileName==%22Example%20Name%22");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/admin/whoiscontactprofiles?filter=profileName==%22Example%20Name%22"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: query
name: filter
description: |
Filters can be applied to your request to limit the type of data you receive.
#### Selectors
Selectors can be used to filter by specific properties on the whois contact profile.
- profileName
- firstName
- lastName
- organization
- street1
- street2
- city
- stateProvince
- country
- postalCode
- email
- phone
- phoneExtn
- fax
- contactTypes
---
#### Search Operators
==
=gt= (greater than)
=ge= (greater than or equal)
=lt= (less than)
=le= (less than or equal)
=in=
=like=
#### Joiners
>
Joiners can be used to create compound filters.
> **;** (and)
> **,** (or)
#### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all profiles with a last name of Jones
``` lastName=="Jones" ```
Find all profiles with a last name like Jo
``` lastName=like="Jo*" ```
Find all profiles with a last name of Jones and a contact type of REGISTRANT
``` lastName=="Jones";contactTypes=="REGISTRANT" ```
Find all profiles with a contact type of TECHNICAL or ADMINISTRATIVE
``` contactTypes=in=(ADMINISTRATIVE, TECHNICAL) ```
Find all profiles with a first name of Chuck OR a last name of Smith, in ascending order by profile name
``` firstName=="Chuck",lastName=="Smith"&sort=profileName,asc ```
Find all profiles by profile name Foo & Bar (encoded)
``` profileName=="Foo%20%26%20Bar" ```
---
required: false
schema:
type: string
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/Size'
- $ref: '#/components/parameters/Sort'
responses:
'200':
description: successful operation
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/WhoisContactProfilePagedResource'
'/dsrecord/{qualifiedDomainName}':
get:
tags:
- dsrecords
summary: Get all DS records for a qualified domain name
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/dsrecord/example.com -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]"
```
Java
```java
package com.cscglobal.dsrecord;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class DSRecordGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/dsrecord/example.com");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/dsrecord/example.com"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: qualifiedDomainName
description: Qualified domain name
required: true
schema:
type: string
example: example.com
responses:
'200':
$ref: '#/components/responses/DsRecordResource'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/NoPermission'
'404':
$ref: '#/components/responses/DomainNotFound'
'500':
$ref: '#/components/responses/InternalServerError'
/dsrecord:
post:
tags:
- dsrecords
summary: Add one DS record to a domain
description: |
Code examples
CURL
```bash
curl -X POST https://apis.cscglobal.com/dbs/api/v2/dsrecord -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Content-Type: application/json" -d @myRequest.txt
```
Java
```java
package com.cscglobal.dsrecord;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class DSRecordAdd {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/dsrecord");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("POST");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/dsrecord"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: Required payload of the DS record to be added.
content:
application/json:
schema:
$ref: '#/components/schemas/DSRecordRequest'
responses:
'200':
$ref: '#/components/responses/DSRecordResponseResource'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/NoPermission'
'404':
$ref: '#/components/responses/DomainNotFound'
'500':
$ref: '#/components/responses/InternalServerError'
/dsrecord/all:
delete:
tags:
- dsrecords
summary: Delete all DS records for the given domain name
description: |
Code examples
CURL
```bash
curl -X DELETE https://apis.cscglobal.com/dbs/api/v2/dsrecord/all -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Content-Type: application/json" -d @dsrecord.txt
```
Java
```java
package com.cscglobal.dsrecord;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class DSRecordDelete {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/dsrecord/all");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("DELETE");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Content-Type", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/dsrecord/all"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.delete(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: The details required to delete all DS records.
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BaseDSRecordsRequest'
responses:
'200':
$ref: '#/components/responses/DSRecordResponseResource'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/NoPermission'
'404':
$ref: '#/components/responses/DomainNotFound'
'500':
$ref: '#/components/responses/InternalServerError'
/dsrecord/single:
delete:
tags:
- dsrecords
summary: Delete a single DS record for a domain
description: |
Code examples
CURL
```bash
curl -X DELETE https://apis.cscglobal.com/dbs/api/v2/dsrecord/single -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Content-Type: application/json" -d @dsrecord.txt
```
Java
```java
package com.cscglobal.dsrecord;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class DSRecordDelete {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/dsrecord/single");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("DELETE");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Content-Type", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/dsrecord/single"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.delete(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: The details required to delete a single DS record from a domain
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DSRecordDeleteSingleRequest'
responses:
'200':
$ref: '#/components/responses/DSRecordResponseResource'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/NoPermission'
'404':
$ref: '#/components/responses/DomainNotFound'
'500':
$ref: '#/components/responses/InternalServerError'
/token/refresh:
put:
tags:
- token
summary: Refresh expired token
description: |
Code Examples
CURL
```
curl -X PUT https://apis.cscglobal.com/dbs/api/v2/token/refresh -H \"Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]\" -H \"apikey: [YOUR_API_KEY_HERE]\"
```
Java before 11
```java
package com.cscglobal.token;
import java.net.URL;
import java.net.HttpURLConnection;
import java.IO.IOException;
public class TokenRefresh {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/token/refresh");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("PUT");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Java 11 and beyond
In jshell try:
```jshell
import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import static java.time.temporal.ChronoUnit.SECONDS;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://apis.cscglobal.com/dbs/api/v2/token/refresh"))
.header("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]")
.header("apikey", "[YOUR_API_KEY_HERE]")
.timeout(Duration.of(5, SECONDS))
.PUT(HttpRequest.BodyPublishers.noBody())
.build();
try {
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.discarding());
System.out.printf("%s %s", response.statusCode(), response.body());
} catch (IOException | InterruptedException e) {
throw new RuntimeException(e);
}
```
Python
```
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/token/refresh"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
resp = requests.put(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
responses:
'200':
description: Completed successfully
'400':
$ref: '#/components/responses/TokenBadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/NoPermission'
'500':
$ref: '#/components/responses/InternalServerError'
'503':
$ref: '#/components/responses/ServiceUnavailable'
'/urlf/{qualifiedDomainName}':
get:
tags:
- urlf
summary: Get URL forwarding data by qualified domain name
description: |
Code examples
CURL
```bash
curl -X GET https://apis.cscglobal.com/dbs/api/v2/urlf/example.com -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.urlf;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class UrlfGet {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/urlf/example.com");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/urlf/example.com"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.get(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: qualifiedDomainName
description: Qualified domain name
required: true
schema:
type: string
example: example.com
responses:
'200':
description: URL forwarding record(s) found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/UrlForwardingRecords'
application/xml:
schema:
$ref: '#/components/schemas/UrlForwardingRecords'
'400':
description: Malformed request
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Domain not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAINNAME_NOTFOUND
description: Domain name not found
value: example.com
'500':
description: Internal Server Error. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ''
description: An unexpected error occurred...
value: ''
delete:
tags:
- urlf
summary: Delete URL forwarding by qualified domain name
description: |
Code examples
CURL
```bash
curl -X DELETE https://apis.cscglobal.com/dbs/api/v2/urlf/example.com -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.urlf;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class UrlfDelete {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/urlf/example.com");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("DELETE");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/urlf/example.com"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.delete(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: qualifiedDomainName
description: Qualified domain name
required: true
schema:
type: string
example: example.com
responses:
'200':
description: URL forwarding record(s) removed
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/UrlForwardingDeleteAllResult'
'400':
description: Malformed request
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_URLF_NODES
description: There are no forwarding nodes to delete
value: example.com
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAINNAME_NOTFOUND
description: Domain name not found
value: example.com
'500':
description: Internal Server Error. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ''
description: An unexpected error occurred...
value: ''
'/urlf/{qualifiedDomainName}/node/{nodeName}':
delete:
tags:
- urlf
summary: Delete URL forwarding by qualified domain name and node name
description: |
Code examples
CURL
```bash
curl -X DELETE https://apis.cscglobal.com/dbs/api/v2/example.com/node/node1 -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json"
```
Java
```java
package com.cscglobal.urlf;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
public class UrlfDelete {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/example.com/node/node1");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("DELETE");
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/example.com/node/node1"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
resp = requests.delete(url, headers=headers)
print(resp.status_code)
print(resp.json())
```
parameters:
- in: path
name: qualifiedDomainName
description: Qualified domain name
required: true
schema:
type: string
example: example.com
- in: path
name: nodeName
description: Node name to be deleted
required: true
schema:
type: string
example: node1
responses:
'200':
description: URL forwarding record removed
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/UrlForwardingDeleteResult'
example:
qualifiedDomainName: example.com
message: Redirects have been removed. A subdomain will no longer resolve once a redirect has been removed unless you have updated your zone to point the subdomain to a new address. Please make all necessary zone changes prior to removing any redirects.
nodeRemoved: node1
'400':
description: Malformed request
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_URLF_NODES
description: There are no forwarding nodes to delete
value: example.com
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token invalid
value: 1234-fkef-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAINNAME_NOTFOUND
description: Domain name not found
value: example.com
'500':
description: Internal Server Error. The error message will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ''
description: An unexpected error occurred...
value: ''
/urlf:
put:
tags:
- urlf
summary: Add URL forwarding node
description: |
Code examples
CURL
```bash
curl -X PUT https://apis.cscglobal.com/dbs/api/v2/urlf -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.urlf;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class UrlfAdd {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/urlf");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("PUT");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/urlf"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.put(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: The details required to perform a URL Forwarding.
required: true
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/UrlForwardingRequest'
responses:
'200':
description: URL forwarding submission success
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/UrlForwardingResult'
'400':
description: Bad request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: URLF_DUPLICATE_NODES
description: Nodes must be unique. Please remove duplicate nodes.
value: duplicatenode
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token not provided
value: 1234-pkeb-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Domain not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAINNAME_NOTFOUND
description: Domain name not found.
value: example.com
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ''
description: An unexpected error occurred...
value: ''
/urlf/activate:
put:
tags:
- urlf
summary: Activate URL forwarding node
description: |
Code examples
CURL
```bash
curl -X PUT https://apis.cscglobal.com/dbs/api/v2/urlf/activate -H "Authorization: Bearer [YOUR_BEARER_TOKEN_HERE]" -H "apikey: [YOUR_API_KEY_HERE]" -H "Accept: application/json" -H "Content-Type: application/json" -d "@myRequest.txt"
```
Java
```java
package com.cscglobal.urlf;
import java.net.URL;
import java.net.HttpURLConnection;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
public class UrlfActivate {
public static void main(String[] args) throws IOException {
URL url = new URL("https://apis.cscglobal.com/dbs/api/v2/urlf/activate");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("PUT");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Bearer [YOUR_BEARER_TOKEN_HERE]");
http.setRequestProperty("apikey", "[YOUR_API_KEY_HERE]");
http.setRequestProperty("Accept", "application/json");
http.setRequestProperty("Content-Type", "application/json");
String data = "[YOUR JSON REQUEST HERE]";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
}
}
```
Python
```python
import requests
from requests.structures import CaseInsensitiveDict
url = "https://apis.cscglobal.com/dbs/api/v2/urlf/activate"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer [YOUR_BEARER_TOKEN_HERE]"
headers["apikey"] = "[YOUR_API_KEY_HERE]"
headers["Accept"] = "application/json"
headers["Content-Type"] = "application/json"
data = "[YOUR JSON REQUEST HERE]"
resp = requests.put(url, headers=headers, data=data)
print(resp.status_code)
print(resp.json())
```
requestBody:
description: The details required to activate a URL Forwarding.
required: true
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/UrlForwardingActivateRequest'
responses:
'200':
description: URL forwarding activation success
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/UrlForwardingActivateResult'
'201':
description: URL forwarding already activated
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/UrlForwardingActivateResultNoEditsRequired'
'400':
description: Bad request. The error code will give more details.
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ZONE_EDITS_NOT_ARRAY
description: Desired zone edits must be expressed as an array in the request payload.
value: ''
'401':
description: No API token
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_TOKEN
description: API bearer token not provided
value: 1234-pkeb-21312-d32d
'403':
description: Not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
'404':
description: Zone not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: ZONE_NOT_FOUND
description: Requested zone not found.
value: node.example.com
'500':
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: UNEXPECTED_ERROR_WHILE_PUBLISHING
description: There was an unexpected issue publishing your request.
value: ''
components:
securitySchemes:
BearerToken:
type: http
in: header
scheme: Bearer
name: bearer
ApiKey:
type: apiKey
in: header
name: apikey
examples:
DomainRegistrationAvailable:
description: The domain is available for registration
value:
meta:
numResults: 1
results:
qualifiedDomainName: example.com
result:
code: AVAILABLE
message: Domain available for registration
basePrice:
price: 5
currency: USD
availableTerms:
- 12
- 24
- 36
DomainRegistrationNotAvailable:
description: The domain is already registered
value:
meta:
numResults: 1
results:
qualifiedDomainName: example.com
result:
code: ALREADY_REGISTERED
message: Domain Already Registered
basePrice:
price: null
currency: ''
availableTerms: []
parameters:
AcceptParam:
in: header
name: Accept
description: Response data type
required: false
schema:
type: string
example: application/json
FilterOrgContacts:
name: filter
in: query
required: false
schema:
type: string
example: null
description: |
Filters can be applied to your request to limit the type of data you receive.
### Selectors
Selectors can be used to filter by specific properties on the SSL Contact records.
Text Fields:
- profileName
- organizationName
- firstName
- lastName
- street1
- street2
- street3
- city
- stateProvence
- countryId
- postalCode
- email
- phone
- phoneExtn
Date Fields:
- validationDate
Boolean Fields:
- validated
---
### Validation Date
The 'validation date' selector must have the following format:
yyyy/MM/dd
---
### Search Operators
| Operator | Name |
|----------|--------------------------|
| == | Equals |
| =gt= | Greater Than |
| =ge= | Greater Than or Equal to |
| =lt= | Less Than |
| =le= | Less Than or Equal to |
| =in= | In a list |
| =like= | Wild card searching |
---
### Joiners
Joiners can be used to create compound filters.
| Joiner | Name |
|--------|------|
| ; | And |
| , | Or |
---
### Special Considerations
1. Surround values in double quotes. If the value is a single alphanumeric term, the quotes can be omitted.
2. If a value contains a double quote (") or a backslash (\), it must be escaped with a backslash.
3. Ampersand and non-ascii characters must be URL encoded.
---
### Examples
Click to view - All examples exclude the required preceding "filter="
Find all contacts in Germany.
```
filter=countryId==de
```
Find all contacts in Berlin, Germany
```
filter=countryId==de;city==berlin
```
Find all validated contacts in Germany, France or United Kingdom or all contacts in the state
of Wisconsin, USA
```
filter=validated==true;countryId=in=(de,fr,uk),stateProvence==wi;countryId=us
```
Find all Contacts with a firstName like example
```
filter=firstName=like="example\*"
```
Page:
name: page
in: query
description: Page number
required: false
schema:
type: integer
minimum: 1
example: 1
Size:
name: size
in: query
description: Page size
required: false
schema:
type: integer
minimum: 1
default: 15000
example: 100
Sort:
name: sort
in: query
description: 'Specify how results should be sorted: *propertyName*,(desc|asc)'
schema:
type: string
example: 'propertyName,asc'
SortOrgContacts:
name: sort
in: query
description: 'Specify how results should be sorted: *propertyName*,(desc|asc)'
required: false
schema:
type: string
example: 'firstName,asc'
ZoneEditSize:
name: size
in: query
description: Page size
required: false
schema:
type: integer
minimum: 1
default: 1000
example: 100
responses:
BadRequest:
description: Required Parameter is missing
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
DOMAIN_IS_NOT_ACTIVE:
summary: The requested domain is not active
value:
code: DOMAIN_IS_NOT_ACTIVE
description: Domain is not active
value: test.com
REQUIRED_PARAM_MISSING:
summary: The request is missing a value for the parameter indicated in the 'value' field of the response body.
value:
code: REQUIRED_PARAM_MISSING
description: Required parameter is missing
value: qualifiedDomainName
DomainNotFound:
description: Domain not found
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: DOMAIN_NOT_FOUND
description: Domain not found
value: example.com
DsRecordResource:
description: Contains DsRecords for the requested domain
content:
application/json;charset=UTF-8:
schema:
properties:
qualifiedDomainName:
type: string
example: example.com
dsRecords:
type: array
items:
$ref: '#/components/schemas/DsRecord'
DSRecordResponseResource:
description: Contains the response to a DS record action.
content:
application/json;charset=UTF-8:
schema:
properties:
result:
$ref: '#/components/schemas/DSRecordModificationResource'
InternalServerError:
description: Internal Server Error
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
NO_CONTENT_TYPE:
summary: Missing Content-type value in header
value:
code: ''
description: 'An unexpected error occurred. Please try again later. If the issue persists, please contact support'
value: ''
NO_REQUEST_BODY:
summary: The request body is missing
value:
code: ''
description: 'An unexpected error occurred. Please try again later. If the issue persists, please contact support'
value: ''
MALFORMED_REQUEST_BODY:
summary: The request body is incorrect.
value:
code: ''
description: 'An unexpected error occurred. Please try again later. If the issue persists, please contact support'
value: ''
EXTERNAL_SERVICE_COMMUNICATION_ERROR:
summary: An Error has occurred while communicating with an external service
value:
code: EXTERNAL_SERVICE_COMMUNICATION_ERROR
description: An error has occurred while communicating with an external service
value: ''
NoPermission:
description: User is not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: NO_PERMISSION
description: No permission for requested action
value: ''
ServiceUnavailable:
description: 'The service is not available at this time, please try again later'
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
value:
code: ''
description: ''
value: ''
TokenBadRequest:
description: Authorization Issue
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
examples:
TOKEN_IS_ALREADY_ACTIVE:
summary: The API bearer token is already active
value:
code: TOKEN_IS_ALREADY_ACTIVE
description: The token is already active
value: ''
TOKEN_NOT_REFRESHABLE:
summary: The API bearer token cannot be refreshed
value:
code: TOKEN_NOT_REFRESHABLE
description: 'Unable to refresh: Not the most current token or has not been used > 60 days'
value: 01-Nov-2022
TOKEN_REVOKED:
summary: The API bearer token has been revoked
value:
code: TOKEN_REVOKED
description: 'Unable to refresh, token has been revoked'
value: ''
NO_TOKEN:
summary: The API bearer token was not present in the request header
value:
code: NO_TOKEN
description: API bearer token not provided
value: ''
Unauthorized:
description: User is not authorized
content:
application/json;charset=UTF-8:
schema:
$ref: '#/components/schemas/ErrorMessage'
example:
code: TOKEN_INVALID
description: API bearer Token invalid
value: ''
schemas:
Account:
type: object
properties:
accountNumber:
type: string
example: 1234567
accountName:
type: string
example: CSC
AccountCustomField:
type: object
properties:
label:
type: string
example: UDF List
description: Name of the custom field as defined in the account
values:
type: array
items:
type: string
example: '["ListVal1", "ListVal2", "ListVal3"]'
mandatory:
type: boolean
example: true
description: Is this a required field to include with orders?
includedOnInvoice:
type: boolean
example: true
description: Is a required field to be included on invoicing?
account:
$ref: '#/components/schemas/Account'
AccountCustomFields:
type: object
properties:
customFields:
type: array
items:
$ref: '#/components/schemas/AccountCustomField'
AdditionalNames:
type: array
items:
type: string
example:
- adbcd@cscglobal.com
- mrTest@cscglobal.com
AdditionalNotificationEmails:
type: array
items:
type: string
example:
- adbcd@cscglobal.com
- mrTest@cscglobal.com
BaseDSRecordsRequest:
type: object
properties:
qualifiedDomainName:
description: The full domain name for which the given DS records will be deleted from.
type: string
example: example.com
showPrice:
type: boolean
customFields:
type: array
description: A user provided list of previously defined custom field names and their values.
items:
$ref: '#/components/schemas/CustomFields'
notifications:
$ref: '#/components/schemas/Notifications'
required:
- qualifiedDomainName
BusinessUnit:
type: object
properties:
businessUnitName:
type: string
example: Example Business
usage:
type: array
items:
type: string
enum:
- DOMAIN
- RELATED_SERVICES
- SOCIAL_MEDIA
account:
$ref: '#/components/schemas/Account'
BusinessUnitLinks:
type: object
properties:
self:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/admin/businessUnits'
BusinessUnitsMeta:
type: object
properties:
numResults:
type: integer
example: 1
description: total number of results
pages:
type: integer
example: 1
description: total number of pages
businessUnitModResult:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
status:
type: object
properties:
code:
type: string
example: BUSINESS_UNIT_UPDATED
message:
type: string
example: Business unit successfully updated
additionalInformation:
type: string
example: ''
certificateList:
type: string
enum:
- '0'
- '1'
- '2'
- '3'
- '4'
- '5'
- '6'
example: '0'
description: 'This property is required and the certificates types can be: (CSC TrustedSecure Premium Certificate->0,CSC TrustedSecure Premium Wildcard Certificate->1,CSC TrustedSecure UC Certificate->2,CSC TrustedSecure EV Certificate->3,CSC Trusted Secure Domain Validated SSL->4,CSC Trusted Secure Domain Validated Wildcard SSL->5,CSC Trusted Secure Domain Validated UC->6)'
certificateResponseList:
type: string
enum:
- CSC TrustedSecure Premium Certificate
- CSC TrustedSecure Premium Wildcard Certificate
- CSC TrustedSecure UC Certificate
- CSC TrustedSecure EV Certificate
- CSC Trusted Secure Domain Validated SSL
- CSC Trusted Secure Domain Validated Wildcard SSL
- CSC Trusted Secure Domain Validated UC
- Symantec Secure Site Pro
- Symantec Secure Site Pro with EV SAN
- Symantec Secure Site Pro SAN
- Symantec Secure Site Pro with EV
- Symantec Secure Site
- Symantec Secure Site with EV
- Symantec Secure Site EV SAN
- Symantec Secure Site SAN
- Rapid SSL
- Rapid SSL Wildcard Certificate
- Thawte SSL123 Certificates
- Thawte SGC SuperCerts SAN
- Thawte SGC SuperCerts
- Thawte SSL Web Server Certificate
- Thawte SSL Web Server Certificate SAN
- Thawte SSL Web Server Certificate EV
- Thawte SSL Web Server Certificate EV SAN
- Thawte SSL Web Server Wildcard Certificate
- GeoTrust QuickSSL Premium
- GeoTrust True BusinessID SAN
- GeoTrust True BusinessID
- GeoTrust True BusinessID Wildcard
- GeoTrust True BusinessID EV
- GeoTrust True BusinessID EV SAN
certificateResponseListEV:
type: string
enum:
- CSC TrustedSecure Premium Certificate
- CSC TrustedSecure Premium Wildcard Certificate
- CSC TrustedSecure UC Certificate
- CSC TrustedSecure EV Certificate
example: CSC TrustedSecure EV Certificate
CnameResponse:
type: object
description: cname response object
properties:
zone:
type: string
example: testdomain1.com
type:
type: string
example: CNAME
name:
type: string
example: _CC6668E594FCE8182CC299CE8B9D0AE2.testdomain1.com
value:
type: string
example: 043e86130dd486278fd434d68867c4f7.044a1fa5ff6544df88089605c44e7000.6beb018b3b1f47399ff6.comodoca.com.
ConfigurationCallSuccess:
type: object
properties:
meta:
type: object
properties:
numResults:
type: number
example: 20
pages:
type: number
example: 20
configurations:
type: array
items:
$ref: '#/components/schemas/configurations'
links:
type: object
properties:
self:
type: string
example: /domains/configuration?size=1&page=1
next:
type: string
example: /domains/configuration?size=1&page=2
configurations:
type: object
properties:
domain:
type: string
example: test.com
domainLabel:
type: string
example: test
domainStatusCode:
type: string
example: ACT
dnsHostingType:
$ref: '#/components/schemas/dnsHostingType'
extension:
type: string
example: de
tld:
type: string
example: de
country:
type: string
example: GERMANY
adminEmail:
type: string
example: adminEmail@test.com
adminName:
type: string
example: Admin Name
adminOrg:
type: string
example: Admin Organization
regEmail:
type: string
example: regEmail@test.com
regName:
type: string
example: Reg Name
regOrg:
type: string
example: Reg Organization
techEmail:
type: string
example: techEmail@test.com
techName:
type: string
example: Tech Name
techOrg:
type: string
example: Tech Organization
accounts:
type: object
properties:
accountNumber:
type: string
example: ''
accountName:
type: string
example: ''
businessUnit:
type: string
example: Business Unit One
dnsData:
type: array
items:
$ref: '#/components/schemas/configurationsDnsData'
dnsTraffic12moAve:
type: number
nullable: true
example: 1234
hasCscUrlf:
type: boolean
example: false
hasDkim:
type: boolean
example: false
hasDmarc:
type: boolean
example: false
hasDnssecDs:
type: boolean
example: false
hasSpf:
type: boolean
example: false
hasWww:
type: boolean
example: true
isGtld:
type: boolean
example: false
isLive:
type: boolean
example: true
isLiveType:
type: string
enum:
- Bad Destination
- CSC Parking
- CSC Not Live
- CSC URLF
- Forbidden
- Inconsistent
- Live Site
- Mail Record
- Not Live
- Validate
example: Unauthorized
isMultilockEligible:
type: boolean
example: false
isVital:
type: boolean
example: false
multiLocked:
type: boolean
example: false
numLiveMx:
type: number
nullable: true
example: 0
numRootA:
type: number
nullable: true
example: 1
numRootTxt:
type: number
nullable: true
example: 0
numSslNetcraft:
type: number
nullable: true
example: 0
numWwwA:
type: number
nullable: true
example: 0
numWwwCname:
type: number
nullable: true
example: 1
registryExpiryDate:
type: string
nullable: true
example: 2022-12-31T00:00:00.000Z
rootHttpCode:
type: number
nullable: true
example: 301
rootHttpUrl:
type: string
nullable: true
example: test.com
rootIsUrlf:
type: boolean
example: null
serverDeleteProhibited:
type: boolean
example: false
serverTransferProhibited:
type: boolean
example: true
serverUpdateProhibited:
type: boolean
example: true
urlfTraffic12moAve:
type: number
nullable: true
example: 1
valueRootA:
type: array
items:
type: string
example: 123.123.123.123
valueRootMx:
type: array
items:
type: string
example: custmx.cscdns.net
valueRootTxt:
type: array
items:
type: string
example: ''
valueWwwA:
type: array
items:
type: string
example: 123.123.123.123
valueWwwCname:
type: array
items:
type: string
example: ''
wwwHttpeCode:
type: number
nullable: true
example: 301
wwwHttpUrl:
type: string
nullable: true
example: test.com
wwwIsUrlf:
type: boolean
example: null
configurationsDnsData:
type: object
properties:
dnsData:
type: string
example: dnsData
dnsName:
type: string
example: CSC DNS
country:
type: string
enum:
- AA
- AC
- AD
- AE
- AF
- AG
- AI
- AL
- AM
- AN
- AO
- AQ
- AR
- AS
- AT
- AU
- AW
- AX
- AZ
- BA
- BB
- BC
- BD
- BE
- BF
- BG
- BH
- BI
- BJ
- BL
- BM
- BN
- BO
- BQ
- BR
- BS
- BT
- BU
- BV
- BW
- BY
- BZ
- CA
- CC
- CD
- CE
- CF
- CG
- CH
- CI
- CK
- CL
- CM
- CN
- CO
- CQ
- CR
- CS
- CU
- CV
- CW
- CX
- CY
- CZ
- DE
- DJ
- DK
- DM
- DO
- DR
- DZ
- EC
- EE
- EG
- EH
- ER
- ES
- ET
- EU
- FI
- FJ
- FK
- FL
- FM
- FO
- FR
- FX
- GA
- GB
- GD
- GE
- GF
- GG
- GH
- GI
- GL
- GM
- GN
- GP
- GQ
- GR
- GS
- GT
- GU
- GW
- GY
- HK
- HM
- HN
- HR
- HT
- HU
- IC
- ID
- IE
- IL
- IM
- IN
- IO
- IQ
- IR
- IS
- IT
- JE
- JM
- JO
- JP
- KE
- KG
- KH
- KI
- KM
- KN
- KP
- KR
- KW
- KY
- KZ
- LA
- LB
- LC
- LI
- LK
- LR
- LS
- LT
- LU
- LV
- LY
- MA
- MC
- MD
- ME
- MG
- MH
- MI
- MK
- ML
- MM
- MN
- MO
- MP
- MQ
- MR
- MS
- MT
- MU
- MV
- MW
- MX
- MY
- MZ
- NA
- NC
- NE
- NF
- NG
- NI
- NL
- 'NO'
- NP
- NR
- NT
- NU
- NZ
- OM
- 'ON'
- PA
- PC
- PE
- PF
- PG
- PH
- PK
- PL
- PM
- PN
- PR
- PS
- PT
- PW
- PY
- QA
- QC
- RE
- RM
- RO
- RS
- RU
- RW
- SA
- SB
- SC
- SD
- SE
- SG
- SH
- SI
- SJ
- SK
- SL
- SM
- SN
- SO
- SP
- SR
- ST
- SU
- SV
- SW
- SX
- SY
- SZ
- TC
- TD
- TF
- TG
- TH
- TJ
- TK
- TL
- TM
- TN
- TO
- TP
- TR
- TT
- TV
- TW
- TZ
- UA
- UD
- UG
- UK
- UM
- UN
- UR
- US
- UY
- UZ
- VA
- VC
- VE
- VG
- VI
- VN
- VU
- WF
- WS
- XX
- YE
- YS
- YT
- YU
- ZA
- ZM
- ZR
- ZW
example: US
description: This property is mandatory
CustomField:
type: object
properties:
name:
type: string
example: Cost Center
description: Name of the custom field as defined in Domain Manager
value:
type: string
example: Marketing
CustomFields:
type: object
properties:
name:
type: string
value:
type: string
customFieldModRequest:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
updateOpenOrders:
type: boolean
description: Defaults to false
customFields:
type: array
items:
$ref: '#/components/schemas/CustomField'
required:
- qualifiedDomainName
- customFields
customFieldModResult:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
status:
type: object
properties:
code:
type: string
example: CUSTOM_FIELD_UPDATED
message:
type: string
example: Custom field(s) successfully updated
additionalInformation:
type: string
example: ''
dcvDetails:
type: object
properties:
domainName:
type: string
example: cscdbs-test-domain-02092020.com
description: given common name
actionNeeded:
type: string
example: 'Y'
description: 'If this value is ''Y'', for CNAME type domain control validation, CNAME needs to be added to the domain''s zone file and for EMAIL type, authentication steps mentioned in the email should be followed. If the value is ''N'', no action is needed.'
email:
type: string
nullable: true
example: ''
description: This property comes when method type is given EMAIL in the request
cname:
type: object
properties:
name:
type: string
example: _1FEA8C1BB7A8D262E7553DE55CE126EC.cscdbs-test-domain-02092020.com.
value:
type: string
example: 043e86130dd486278fd434d68867c4f7.044a1fa5ff6544df88089605c44e7000.6beb018b3b1f47399ff6.comodoca.com.
DnsChangeRequestedEvent:
type: object
description: Nameserver change requested for domain event.
required:
- type
properties:
domainName:
type: string
description: Domain name target of the event
example: example.com
user:
type: string
description: The user who's action generated this security event.
example: CSC SERVICE REP
ipAddress:
type: string
nullable: true
description: The IP Address of the user who triggered the event. May be null.
example: 1.1.1.1
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2019-10-03T15:42:37Z'
type:
type: string
example: DNS_CHANGE_REQUESTED
account:
$ref: '#/components/schemas/Account'
nameServerNameList:
type: array
items:
type: string
example:
- ns1.cscdns.net
- ns2.cscdns.net
dnsHostingType:
type: string
enum:
- MANAGED_BASIC
- SLAVED_BASIC
- DNS_ADVANCED
- DNS_ULTIMATE
- SLAVED_PREMIUM
- SLAVED_PREMIUM_SINGLE_SERVER
- SLAVED_PREMIUM_DUAL_SERVER
- THIRDPARTY
- MANAGED_PREMIUM
example: MANAGED_BASIC
dnsType:
type: string
enum:
- CSC_BASIC
- MANAGED_BASIC
- CSC_PREMIUM
- CSC_SLAVED_BASIC
- CSC_SLAVED_PREMIUM
- CSC_ADVANCED
- CSC_ULTIMATE
- CSC_SLAVED_PREMIUM_DUAL_SERVER
- CSC_SLAVED_PREMIUM_SINGLE_SERVER
- THIRDPARTY
- OTHER_DNS
example: CSC_BASIC
Domain:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
domain:
type: string
example: example
idn:
type: string
example: ''
extension:
type: string
example: com
newGtld:
type: boolean
example: false
managedStatus:
type: string
example: ACTIVE
enum:
- ACTIVE
- AWAITING_DELETION
- DELETED
- DNS_HOSTING_ONLY
- INCOMING_TRANSFER_IN_PROGRESS
- MOVED_FROM_ACCOUNT
- NOT_CSC_MANAGED
- REGISTRATION_IN_PROGRESS
- TRANSFERRED_AWAY
- TRANSFER_AWAY_IN_PROGRESS
registrationDate:
type: string
example: 09-Dec-2011 UTC
registryExpiryDate:
type: string
example: 09-Dec-2030 UTC
paidThroughDate:
type: string
example: 09-Dec-2030 UTC
countryCode:
type: string
example: ''
serverDeleteProhibited:
type: boolean
example: false
serverTransferProhibited:
type: boolean
example: false
serverUpdateProhibited:
type: boolean
example: false
dnsType:
$ref: '#/components/schemas/dnsType'
whoisPrivacy:
type: boolean
example: false
localAgent:
type: boolean
example: false
dnssecActivated:
type: string
enum:
- ENABLED
- NOT_ENABLED
- USAGE_UNKNOWN
example: ENABLED
criticalDomain:
type: boolean
example: true
businessUnit:
type: string
example: My Business Unit
brandName:
type: string
example: My Brand
idnReferenceName:
type: string
example: ''
customFields:
type: array
maximum: 20
items:
$ref: '#/components/schemas/CustomField'
account:
$ref: '#/components/schemas/Account'
urlf:
$ref: '#/components/schemas/Urlf'
nameServers:
type: array
items:
type: string
xml:
name: nameServers
wrapped: true
example:
- ns1.cscdns.net
- ns2.cscdns.net
whoisContacts:
type: array
maximum: 3
items:
$ref: '#/components/schemas/WhoisContact'
lastModifiedDate:
type: string
example: 20-May-2019 UTC
lastModifiedReason:
type: string
example: RENEWAL_COMPLETE
lastModifiedDescription:
type: string
example: Domain renewed
xml:
name: DomainResource
DomainControlValidation:
type: object
properties:
methodType:
$ref: '#/components/schemas/methodType'
emailAddress:
type: string
description: This property is required when methodType is EMAIL
example: ''
DsRecord:
type: object
properties:
keyTag:
type: integer
description: Used to identify each DS record for the given domain
minimum: 1
maximum: 65535
example: '12345'
algorithm:
type: integer
description: The algorithm id used to generate the DNSKEY-record
example: 251
digestType:
type: integer
description: |
The Cryptographic hash algorithm used to create the Digest value. This code also indicates the implied length of the digest field.
Valid Cryptographic Values, and the expected digest lengths are:
- 1 - Digest is 40 characters in length.
- 2 - Digest is 64 characters in length.
- 3 - Digest is 64 characters in length.
- 4 - Digest is 96 characters in length..
maximum: 4
minimum: 1
digest:
description: The Cryptographic hash value of the DNSKEY-record
type: string
example: '0000000000000000000000000000000000000000'
required:
- keyTag
- algorithm
- digestType
- digest
DSRecordDeleteSingleRequest:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
customFields:
type: array
items:
$ref: '#/components/schemas/CustomFields'
showPrice:
type: boolean
notifications:
$ref: '#/components/schemas/Notifications'
dsRecord:
$ref: '#/components/schemas/DsRecord'
DSRecordRequest:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
customFields:
type: array
items:
$ref: '#/components/schemas/CustomFields'
showPrice:
type: boolean
notifications:
$ref: '#/components/schemas/Notifications'
dsRecord:
$ref: '#/components/schemas/DsRecord'
DSRecordModificationResource:
type: object
properties:
qualifiedDomainName:
description: The full domain name that the action was applied to.
type: string
example: example.com
status:
$ref: '#/components/schemas/ModificationStatusDetailResource'
price:
$ref: '#/components/schemas/ModificationPriceDetailsResource'
EditStatusLinks:
type: object
properties:
cancel:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/zones/edits/12345'
ErrorMessage:
type: object
properties:
code:
type: string
description:
type: string
value:
type: string
nullable: true
EvCertificationDetails:
type: object
properties:
country:
type: string
example: US
city:
type: string
example: Los Angeles
state:
type: string
example: California
dateOfIncorporation:
type: string
example: 12-Apr-2023
doingBusinessAs:
type: string
example: NEED EXAMPLE
businessCategory:
type: string
example: NEED EXAMPLE
Event:
type: object
description: Single security event. One of several formats.
anyOf:
- $ref: '#/components/schemas/DnsChangeRequestedEvent'
- $ref: '#/components/schemas/LapseRequestedEvent'
- $ref: '#/components/schemas/LoginEvent'
- $ref: '#/components/schemas/MultiLockRemovedRequested'
- $ref: '#/components/schemas/NewUserAddedEvent'
- $ref: '#/components/schemas/TransferOutRequestedEvent'
- $ref: '#/components/schemas/UserPermissionAddedEvent'
- $ref: '#/components/schemas/VitalDomainAddedEvent'
- $ref: '#/components/schemas/WhoisContactChangeRequestedEvent'
- $ref: '#/components/schemas/ZoneEditRequestedEvent'
discriminator:
propertyName: type
mapping:
DNS_CHANGE_REQUESTED: DnsChangeRequestedEvent
LAPSE_REQUESTED: LapseRequestedEvent
LOGIN: LoginEvent
MULTILOCK_REMOVED_REQUESTED: MultiLockRemovedRequested
NEW_USER_ADDED: NewUserAddedEvent
TRANSFER_OUT_REQUESTED: TransferOutRequestedEvent
USER_PERMISSION_ADDED: UserPermissionAddedEvent
VITAL_DOMAIN_ADDED: VitalDomainAddedEvent
WHOIS_CONTACT_CHANGE_REQUESTED: WhoisContactChangeRequestedEvent
ZONE_EDIT_REQUESTED: ZoneEditRequestedEvent
EventContact:
type: object
nullable: true
properties:
newContactEmail:
type: string
example: adbcd@cscglobal.com
newContactName:
type: string
example: John Smith
newContactOrg:
type: string
example: Corporation Service Company
LapseRequestedEvent:
type: object
description: Domain lapse requested event.
required:
- type
properties:
domainName:
type: string
description: Domain name target of the event
example: example.com
user:
type: string
description: The user who's action generated this security event.
example: CSC SERVICE REP
ipAddress:
type: string
nullable: true
description: The IP Address of the user who triggered the event. May be null.
example: 1.1.1.1
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2019-10-03T15:42:37Z'
type:
type: string
example: LAPSE_REQUESTED
account:
$ref: '#/components/schemas/Account'
LinePriceResource:
type: object
properties:
price:
type: number
service:
type: string
linePrices:
type: object
properties:
price:
type: integer
example: 24
description: price of service
service:
type: string
example: DNS
linePricesWhoisContactMod:
type: object
properties:
price:
type: integer
example: 20
description: price of service
service:
type: string
example: Domain Modification with Ownership Change
Links:
type: object
properties:
self:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/domains?size=5&page=5'
next:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/domains?size=5&page=6'
LoginEvent:
type: object
description: User login event.
required:
- type
properties:
user:
type: string
description: The user who's action generated this security event.
example: CSC SERVICE REP
ipAddress:
type: string
description: The IP Address of the user who triggered the event. May be null.
example: 1.1.1.1
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2019-10-03T15:42:37Z'
type:
type: string
example: LOGIN
account:
$ref: '#/components/schemas/Account'
Meta:
type: object
properties:
numResults:
type: integer
example: 25
description: total number of results
pages:
type: integer
example: 10
description: total number of pages
methodType:
type: string
enum:
- EMAIL
- CNAME
example: CNAME
ModificationPriceDetailsResource:
type: object
properties:
currency:
type: string
total:
type: number
linePrices:
type: array
items:
$ref: '#/components/schemas/LinePriceResource'
ModificationStatusDetailResource:
type: object
properties:
code:
type: string
message:
type: string
additionalInformation:
type: string
uuid:
type: string
MultiLockRemovedRequested:
type: object
description: Mulilock removed from domain event.
required:
- type
properties:
domainName:
type: string
description: Domain name target of the event
example: example.com
user:
type: string
description: The user who's action generated this security event.
example: CSC SERVICE REP
ipAddress:
type: string
description: The IP Address of the user who triggered the event. May be null.
example: 1.1.1.1
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2019-10-03T15:42:37Z'
type:
type: string
example: MULTILOCK_REMOVED_REQUESTED
account:
$ref: '#/components/schemas/Account'
MultiOrderResponse:
type: object
properties:
meta:
type: object
properties:
numResults:
type: integer
example: 25
ordersList:
type: array
items:
$ref: '#/components/schemas/Order'
MultiTlsRetrieveResponse:
type: object
properties:
meta:
type: object
properties:
numResults:
type: integer
example: 1
results:
type: array
items:
$ref: '#/components/schemas/TlsOrderResponse'
NewUserAddedEvent:
type: object
description: New user added event.
required:
- type
properties:
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2022-10-03T15:42:37Z'
type:
type: string
example: NEW_USER_ADDED
cscUser:
type: object
description: Shows as "user" in API results. Named "cscUser" in JDK objects.
properties:
name:
type: string
example: John Smith
cscUserName:
type: string
example: jsmith01
email:
type: string
example: john.smith@cscglobal.com
Notifications:
type: object
properties:
enabled:
type: boolean
example: true
additionalNotificationEmails:
$ref: '#/components/schemas/AdditionalNotificationEmails'
NsModRequest:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
description: This property is required
nameServers:
type: array
items:
type: string
xml:
name: nameServers
wrapped: true
example:
- ns1.test.com
- ns2.test.com
- ns3.test.com
dnsType:
$ref: '#/components/schemas/dnsType'
notifications:
$ref: '#/components/schemas/Notifications'
showPrice:
type: boolean
example: true
customFields:
type: array
maximum: 20
items:
$ref: '#/components/schemas/CustomField'
NsModRequestResult:
type: object
properties:
result:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
status:
type: object
properties:
code:
$ref: '#/components/schemas/nsModResultCode'
message:
type: string
example: Modification has been successfully submitted
description: A message that corresponds with the response status code
additionalInformation:
type: string
example: Extension rules are missing
description: Any further details/data that is needed for the response
uuid:
type: string
example: 113b4cef-9b4d-4962-9a4e-f3186a7d12ed
price:
type: object
properties:
currency:
type: string
example: USD
total:
type: number
example: 74
linePrices:
type: array
items:
$ref: '#/components/schemas/linePrices'
nsModResultCode:
type: string
enum:
- AWAITING_APPROVAL
- DNS_ALREADY_PRESENT
- DOMAIN_LOCK_UPDATE
- DOMAIN_NOT_FOUND
- EXTENSIONNOTSUPPORTED
- INCOMPLETE_ORDER
- INVALID_ACCESS
- INVALID_DNS_INFORMATION
- INVALID_MINIMUM_NAMESERVERS
- INVALID_ORDERINGCONTACT
- INVALID_RESTRICTED_EXTENSION
- MODINPROGRESS
- NAME_SERVERS_MAX_LIMIT_EXCEEDED
- PREMIUM_DNS_CANNOT_BE_MODIFIED
- REGINPROGRESS
- REJECTION
- SAVEINPROGRESS
- SUBMITTED
- TRANSFERINPROCESS
- INVALID_NAME_SERVERS
example: SUBMITTED
Order:
type: object
description: single order placed in Domain Manager
properties:
qualifiedDomainName:
type: string
example: my-domain.co.uk
accountName:
type: string
example: Test Customer
accountNumber:
type: string
example: 8125306
orderType:
$ref: '#/components/schemas/orderType'
status:
$ref: '#/components/schemas/orderStatus'
raisedBy:
type: string
nullable: true
example: Test User
raisedDate:
type: string
example: '2019/12/06 04:20:33'
uuid:
type: string
nullable: true
example: 4cdfb611-1389-4b32-8271-fc27ca1baaee
orderType:
type: string
enum:
- Lapse
- DS Record Modification
- Modification
- Multilock
- Registration
- Renewal
- Transfer In
- Transfer Out
example: REGISTRATION
orderStatus:
type: string
enum:
- APPROVED
- AWAITING_APPROVAL
- CANCELED
- CANCELLED
- COMPLETE
- COMPLETED
- ERROR
- INCOMPLETE
- INPROCESS
- PREREG
- REJECTED
- SALES_ORDER_LINE_CONVERSION_ERROR
- SAVED
- SAVED_INPROGRESS
- SUBMITTED
example: INPROCESS
OrgContactLinks:
type: object
properties:
self:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/tls/orgcontacts?size=5&page=5'
next:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/tls/orgcontacts?size=5&page=6'
OrgContactProfileItem:
type: object
properties:
profileName:
type: string
nullable: true
example: US-ssl-contact
organizationName:
type: string
nullable: true
example: Eastern Region
firstName:
type: string
nullable: true
example: Pat
lastName:
type: string
nullable: true
example: Smith
street1:
type: string
nullable: true
example: 123 Somewhere street
street2:
type: string
nullable: true
example: Apt
street3:
type: string
nullable: true
example: null
city:
type: string
nullable: true
example: Atown
stateProvince:
type: string
nullable: true
example: Delaware
countryId:
$ref: '#/components/schemas/country'
postalCode:
type: string
nullable: true
example: 19808
email:
type: string
nullable: true
example: john.lee@cscglobal.com
phone:
type: string
nullable: true
example: 1.123456789
phoneExtn:
type: string
nullable: true
example: 1234
validated:
description: An internal field that indicates the contact has been validated by CSC.
type: boolean
nullable: true
example: true
validationDate:
type: string
nullable: true
example: 17-Feb-2022
PagedBusinessUnitResponse:
type: object
properties:
meta:
$ref: '#/components/schemas/BusinessUnitsMeta'
businessUnits:
type: array
items:
$ref: '#/components/schemas/BusinessUnit'
links:
$ref: '#/components/schemas/BusinessUnitLinks'
PagedDomainResponse:
type: object
properties:
meta:
$ref: '#/components/schemas/Meta'
domains:
type: array
items:
$ref: '#/components/schemas/Domain'
links:
$ref: '#/components/schemas/Links'
PagedEventResponse:
type: object
properties:
meta:
$ref: '#/components/schemas/Meta'
events:
type: array
items:
$ref: '#/components/schemas/SecurityEvent'
links:
$ref: '#/components/schemas/Links'
PagedSSLOrgContactResponse:
type: object
properties:
meta:
$ref: '#/components/schemas/Meta'
SSLContactProfiles:
type: array
items:
$ref: '#/components/schemas/OrgContactProfileItem'
links:
$ref: '#/components/schemas/OrgContactLinks'
PagedZoneEditResponse:
type: object
description: Single page of zone edit data
properties:
meta:
$ref: '#/components/schemas/Meta'
zoneEdits:
type: array
items:
$ref: '#/components/schemas/ZoneEdit'
links:
$ref: '#/components/schemas/Links'
PagedZoneResponse:
type: object
description: Single page of zone portfolio data
properties:
meta:
$ref: '#/components/schemas/Meta'
zones:
type: array
items:
$ref: '#/components/schemas/Zone'
notManaged:
type: object
nullable: true
properties:
code:
type: string
message:
type: string
domainNames:
type: array
items:
type: string
links:
$ref: '#/components/schemas/Links'
publishJobResultCode:
type: string
enum:
- SUCCESS
- FAILED
- NOT_RUNNABLE
example: SUCCESS
PublishLinks:
type: object
properties:
self:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/zones/edits/1234'
status:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/zones/edits/1234'
RegistrationAvailabilityResult:
type: object
properties:
meta:
$ref: '#/components/schemas/Meta'
results:
type: array
items:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
result:
type: object
properties:
code:
type: string
example: AVAILABLE
description: Availability result
message:
type: string
example: Domain available for registration
basePrice:
type: object
properties:
price:
type: number
nullable: true
example: 5
currency:
type: string
example: USD
availableTerms:
type: array
items:
type: number
example:
- 12
- 24
- 36
- 48
description: List of the terms (months) available for registration
RegistrationRequest:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
description: This property is required
businessUnit:
type: string
example: BUS
description: The business unit's code
accountNumber:
type: integer
example: 1234567
term:
type: integer
example: 12
brand:
type: string
example: myCoolBrand
useAccountMasking:
type: boolean
example: true
owner:
type: string
example: Sara
description: Include only if requesting account masking
whoisContacts:
type: object
properties:
registrantProfile:
type: string
example: Johan
description: This property is required unless requesting account masking
adminProfile:
type: string
example: Lee
description: This property is required unless requesting account masking
technicalProfile:
type: string
example: Peter
description: This property is required unless requesting account masking
nameServers:
type: array
items:
type: string
xml:
name: nameServers
wrapped: true
example:
- ns1.test.com
- ns2.test.com
- ns3.test.com
dnsType:
$ref: '#/components/schemas/dnsType'
notes:
type: string
example: this is a note
notifications:
$ref: '#/components/schemas/Notifications'
redactPublicWhois:
type: boolean
example: true
showPrice:
type: boolean
example: true
customFields:
type: array
maximum: 20
items:
$ref: '#/components/schemas/CustomField'
RegistrationRequestResult:
type: object
properties:
result:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
status:
type: object
properties:
code:
$ref: '#/components/schemas/registrationResultCode'
message:
type: string
example: Order has been successfully submitted
description: A message that corresponds with the response status code
additionalInformation:
type: string
example: Extension rules are missing
description: Any further details/data that is needed for the response
uuid:
type: string
example: 113b4cef-9b4d-4962-9a4e-f3186a7d12ed
price:
type: object
properties:
currency:
type: string
example: USD
total:
type: number
example: 74
linePrices:
type: array
items:
$ref: '#/components/schemas/linePrices'
registrationResultCode:
type: string
enum:
- ALREADY_REGISTERED
- AVAILABLE_CLAIMS
- AVAILABLE_PREMIUM
- AVAILABLE_RESERVED
- BU_NOT_DETERMINED
- DOMAIN_IN_PORTFOLIO
- DOMAINNAME_ENDWITH
- DOMAINNAME_NUMBER_CHARACTERS
- DOMAINNAME_STARTWITH
- DOMAINNAME_VALID_CHARACTERS
- DOMAINNAME_WHITESPACES
- DOMAINNAMES_REQUIRED
- ERROR
- EXTENSION_NOT_AVAILABLE
- EXTENSION_NOT_IN_GA_PHASE
- IDN_NOT_SUPPORTED
- INCOMPLETE
- INVALID_ACCOUNT
- INVALID_BUSINESS_UNIT
- INVALID_DNS_INFORMATION
- INVALID_DNS_TYPE
- INVALID_IDN_DOMAIN
- INVALID_NAME_SERVERS
- NAME_SERVERS_MAX_LIMIT_EXCEEDED
- NO_PERMISSION
- NO_TOKEN
- OPEN_REQUEST
- SUBMITTED
- TLD_LENGTH_NOT_GREATER_THAN_1
example: SUBMITTED
description: Describes the status of the registration request made
resourceRecordType:
type: string
enum:
- A
- AAAA
- CAA
- CNAME
- MX
- NS
- SOA
- SRV
- TXT
example: CNAME
RevokeTlsOrderResponse:
type: object
properties:
commonName:
type: string
example: test-domain11.com
certificateType:
type: string
example: CSC TrustedSecure Premium Wildcard Certificate
status:
type: string
example: SUBMITTED
SecurityEvent:
type: object
description: Security events.
properties:
id:
type: string
example: 6eb7ad20-0f90-4a31-b91b-a66ef6033b37
event:
$ref: '#/components/schemas/Event'
subjectAlternativeNames:
type: object
properties:
domainName:
type: string
example: test1.cscdbs-test-domain-02092020.com
description: additional name
domainControlValidation:
description: This property is required
$ref: '#/components/schemas/DomainControlValidation'
TLSCnameRequest:
type: object
properties:
csr:
type: string
example: '---csr certificate value (base 64 encoded) --'
description: 'This property is required ,CSR attribute will accept a base 64 encoded CSR'
additionalNames:
$ref: '#/components/schemas/AdditionalNames'
TlsCnameResponse:
type: object
properties:
meta:
type: object
properties:
numResults:
type: integer
example: 1
results:
type: array
items:
$ref: '#/components/schemas/CnameResponse'
TlsOrderResponse:
type: object
description: tls review api response object
properties:
uuid:
type: string
example: 1b377bdd-2057-4b2a-a788-fb13ddacc94d
commonName:
type: string
example: cscdbs-testdomain.com
additionalNames:
$ref: '#/components/schemas/AdditionalNotificationEmails'
certificateType:
$ref: '#/components/schemas/certificateResponseList'
status:
type: string
example: PENDING
effectiveDate:
type: string
nullable: true
example: 07-Oct-2014
isRenewed:
type: boolean
example: false
expirationDate:
type: string
nullable: true
example: 07-Oct-2014
businessUnit:
type: string
example: baseline business unit A
orderedBy:
type: string
example: testuser
orderDate:
type: string
example: 07-Oct-2014
serverSoftware:
type: string
nullable: true
example: null
certificate:
type: string
example: '---certificate value ---'
account:
$ref: '#/components/schemas/Account'
customFields:
type: array
maximum: 20
items:
$ref: '#/components/schemas/CustomField'
TlsRegistrationRequest:
type: object
properties:
csr:
type: string
example: '---csr certificate value (base 64 encoded) --'
description: 'This property is required, CSR attribute will accept a base 64 encoded CSR'
certificateType:
$ref: '#/components/schemas/certificateList'
businessUnit:
type: string
example: testBu
description: This property is required
term:
type: string
example: '12'
description: This property is required
serverSoftware:
type: string
example: '2'
description: This property is required
organizationContact:
type: string
example: testContact
description: This property is required
domainControlValidation:
description: This property is required
$ref: '#/components/schemas/DomainControlValidation'
notifications:
$ref: '#/components/schemas/Notifications'
evCertificationDetails:
$ref: '#/components/schemas/EvCertificationDetails'
description: This is not required for all registrations
showPrice:
type: boolean
example: true
customFields:
type: array
maximum: 20
items:
$ref: '#/components/schemas/CustomField'
notes:
type: string
example: Test notes
applicantFirstName:
type: string
example: John
description: This property is required
applicantLastName:
type: string
example: Test
description: This property is required
applicantEmailAddress:
type: string
example: sampleTest@cscglobal.com
description: This property is required
applicantPhoneNumber:
type: string
example: +01.23456789
description: This property is required
TLSReissueRequest:
type: object
properties:
uuid:
type: string
example: 00a9ad8c-94c3-4529-8446-632e148fe756
description: This property is required
csr:
type: string
example: '---csr certificate value value (base 64 encoded)--'
description: 'This property is required ,CSR attribute will accept a base 64 encoded CSR'
serverSoftware:
type: string
example: '2'
description: 'This property is required , refer above software values for required software'
domainControlValidation:
description: This property is required
$ref: '#/components/schemas/DomainControlValidation'
notifications:
$ref: '#/components/schemas/Notifications'
showPrice:
type: boolean
example: true
customFields:
type: array
maximum: 20
items:
$ref: '#/components/schemas/CustomField'
evCertificateDetails:
type: object
description: This object is mandatory for certificate type EV (i.e "3")
properties:
country:
$ref: '#/components/schemas/country'
city:
type: string
example: New York
state:
type: string
example: US
dateOfIncorporation:
type: string
example: 12-Aug-2020
doingBusinessAs:
type: string
example: testname
businessCategory:
type: string
example: category
applicantFirstName:
type: string
example: John
description: This property is required
applicantLastName:
type: string
example: Test
description: This property is required
applicantEmailAddress:
type: string
example: sampleTest@cscglobal.com
description: This property is required
applicantPhoneNumber:
type: string
example: +01.23456789
description: This property is required
TLSRenewalRequest:
type: object
properties:
uuid:
type: string
example: 00a9ad8c-94c3-4529-8446-632e148fe756
description: This property is required
csr:
type: string
example: '---csr certificate value (base 64 encoded) --'
description: 'This property is required ,CSR attribute will accept a base 64 encoded CSR'
term:
type: string
example: '12'
description: This property is required
serverSoftware:
type: string
example: '2'
description: 'This property is required , refer above software values for required software'
domainControlValidation:
description: This property is required
$ref: '#/components/schemas/DomainControlValidation'
subjectAlternativeNames:
type: array
description: This property is optional for certificate type UCC i.e certificateType 2 and not required for others certificates
items:
$ref: '#/components/schemas/subjectAlternativeNames'
notifications:
$ref: '#/components/schemas/Notifications'
showPrice:
type: boolean
example: true
notes:
type: string
example: test notes
customFields:
type: array
maximum: 20
items:
$ref: '#/components/schemas/CustomField'
applicantFirstName:
type: string
example: John
description: This property is required
applicantLastName:
type: string
example: Test
description: This property is required
applicantEmailAddress:
type: string
example: sampleTest@cscglobal.com
description: This property is required
applicantPhoneNumber:
type: string
example: +01.23456789
description: This property is required
TlsResponse:
type: object
properties:
result:
type: object
properties:
commonName:
type: string
example: cscdbs-test-domain-02092020.com
status:
type: object
properties:
code:
$ref: '#/components/schemas/tlsResultCode'
message:
type: string
example: Order has been successfully submitted
description: A message that corresponds with the response status code
additionalInformation:
type: string
example: You have chosen to use CNAME records to validate control of your domain. Please add the CNAME records to your DNS.
description: Any further details/data that is needed for the response
uuid:
type: string
example: 113b4cef-9b4d-4962-9a4e-f3186a7d12ed
certificateType:
$ref: '#/components/schemas/certificateResponseList'
price:
type: object
properties:
currency:
type: string
example: USD
total:
type: number
nullable: true
example: 74
dcvDetails:
type: array
items:
$ref: '#/components/schemas/dcvDetails'
TlsResponseEV:
type: object
properties:
result:
type: object
properties:
commonName:
type: string
example: cscdbs-test-domain-02092020.com
status:
type: object
properties:
code:
$ref: '#/components/schemas/tlsResultCode'
message:
type: string
example: Order has been successfully submitted
description: A message that corresponds with the response status code
additionalInformation:
type: string
example: You have chosen to use CNAME records to validate control of your domain. Please add the CNAME records to your DNS.
description: Any further details/data that is needed for the response
uuid:
type: string
example: 113b4cef-9b4d-4962-9a4e-f3186a7d12ed
certificateType:
$ref: '#/components/schemas/certificateResponseListEV'
price:
type: object
properties:
currency:
type: string
example: USD
total:
type: number
example: 74
dcvDetails:
type: array
items:
$ref: '#/components/schemas/dcvDetails'
TlsResponseUCC:
type: object
properties:
result:
type: object
properties:
commonName:
type: string
example: cscdbs-test-domain-02092020.com
status:
type: object
properties:
code:
$ref: '#/components/schemas/tlsResultCode'
message:
type: string
example: Order has been successfully submitted
description: A message that corresponds with the response status code
additionalInformation:
type: string
example: You have chosen to use CNAME records to validate control of your domain. Please add the CNAME records to your DNS.
description: Any further details/data that is needed for the response
uuid:
type: string
example: 113b4cef-9b4d-4962-9a4e-f3186a7d12ed
certificateType:
type: string
example: CSC TrustedSecure UC Certificate
price:
type: object
properties:
currency:
type: string
example: USD
total:
type: number
example: 74
dcvDetails:
type: array
items:
$ref: '#/components/schemas/dcvDetails'
tlsResultCode:
type: string
enum:
- INVALID_ACCESS
- INVALID_BUSINESS_UNIT
- ORDER_NOT_FOUND
- CSR_REQUIRED
- CERTIFICATE_TYPE_REQUIRED
- CERTIFICATE_NOT_SUPPORTED
- BUSINESS_UNIT_REQUIRED
- ORGANIZATION_CONTACT
- TERM_REQUIRED
- INVALID_SERVER_SOFTWARE
- DOMAIN_CONTROL_VALIDATION_REQUIRED
- DCV_EMAIL_REQUIRED
- DCV_EMAIL_INVALID
- COUNTRY_REQUIRED
- INVALID_ORDERINGCONTACT
- INVALID_METHOD_TYPE
- ADDITIONAL_NAMES_EXCEEDDED
- EMPTY_CSR
- INVALID_CSR
- TLS_MALFORMED_COMMONNAME
- TLS_MALFORMED_ADDLNAME
- INVALID_DCV_DOMAIN
- INVALID_ADDITIONAL_NAMES
- INVALID_SANS
- VENDOR_NOT_SUPPORTED
- SSL_PRODUCT_NOT_SUPPORTED
- ADDITIONAL_NAMES_NOT_SUPPORTED_CERT_TYPE
- ADDITIONAL_NAMES_NOT_SUPPORTED_REISSUE_ORDER_TYPE
- DIGITALCERT_TOO_MANY_NAMES
- OPEN_ORDER_INPROGRESS
- INVALID_ORGANIZATION_CONTACT
- INVALID_TERM
- INVALID_KEYWORD
- INVALID_FILTER
- INVALID_DATE_FORMAT
- NO_FILTER_VALUE
- INVALID_FILTER_OPERATOR
- INVALID_FILTER_PROPERTY
- UUID_NOT_PROVIDED
- INVALID_NUMBER
- NO_RECORDS_FOUND
- INVALID_CERTIFICATE_TYPE
- INTER_SERVER_ERROR
- STATUS_ERROR_CODE
- OPEN_ORDER_ERROR_CODE
- EFFECTIVE_DATE_ERROR
- RENEWAL_ORDER_CANNOT_BE_PROCESSED
- REISSUE_ORDER_CANNOT_BE_PROCESSED
- ORDER_CANNOT_PROCEED
- SUBMITTED
example: SUBMITTED
TransferOutRequestedEvent:
type: object
description: Domain transfer requested event.
required:
- type
properties:
domainName:
type: string
description: Domain name target of the event
example: example.com
user:
type: string
description: The user who's action generated this security event.
example: CSC SERVICE REP
ipAddress:
type: string
nullable: true
description: The IP Address of the user who triggered the event. May be null.
example: 1.1.1.1
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2023-01-03T15:42:37Z'
type:
type: string
example: TRANSFER_OUT_REQUESTED
account:
$ref: '#/components/schemas/Account'
Urlf:
type: object
properties:
urlForwarding:
type: boolean
redirectType:
type: string
enum:
- 0
- 301
- 302
- VARIES_BY_SUBDOMAIN
- ''
UrlForwardingActivateRequest:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
node:
type: string
example: node
UrlForwardingActivateResult:
type: object
properties:
link:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/zones/edits/status/4556ef75-7948-497a-98e6-0ca478326448'
status:
type: string
example: Successful
UrlForwardingActivateResultNoEditsRequired:
type: object
properties:
links:
$ref: '#/components/schemas/ZoneEditStatusLinksNoEditsRequired'
UrlForwardingDeleteResult:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
message:
type: string
example: Redirects have been removed. A subdomain will no longer resolve once a redirect has been removed unless you have updated your zone to point the subdomain to a new address. Please make all necessary zone changes prior to removing any redirects. URL forwarding subscription cancelled.
nodeRemoved:
type: string
example: node1
UrlForwardingDeleteAllResult:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
message:
type: string
example: Redirects have been removed. A subdomain will no longer resolve once a redirect has been removed unless you have updated your zone to point the subdomain to a new address. Please make all necessary zone changes prior to removing any redirects. URL forwarding subscription cancelled.
nodesRemoved:
type: array
items:
type: string
example:
- node1
- node2
- node3
UrlForwardingLinePrices:
type: object
properties:
price:
type: number
example: 0
description: price of service
service:
type: string
example: URL Forwarding
UrlForwardingRecord:
type: object
properties:
node:
type: string
example: test
domainName:
type: string
example: example.com
sourceUrl:
description: The node with the domain name.
type: string
example: test.example.com
targetUrl:
type: string
example: 'https://www.myredirect.com'
redirectType:
description: The HTTP redirection status code (3**)
type: string
example: 301
UrlForwardingRecords:
type: object
properties:
urlForwardingRecords:
type: array
items:
$ref: '#/components/schemas/UrlForwardingRecord'
UrlForwardingRequest:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
node:
type: string
example: node.example.com
targetUrl:
type: string
example: 'https://www.redirectme.com'
redirectType:
type: number
example: 301
showPrice:
type: boolean
example: true
customFields:
type: array
items:
$ref: '#/components/schemas/CustomField'
notifications:
$ref: '#/components/schemas/Notifications'
UrlForwardingResult:
type: object
properties:
result:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
status:
type: object
properties:
code:
type: string
example: COMPLETE
message:
type: string
example: URL forwarding has completed
additionalInformation:
type: string
uuid:
type: string
example: 877c37aa-60ac-4d92-a5a4-0da64a4b3e38
price:
type: object
properties:
currency:
type: string
example: USD
total:
type: number
nullable: true
example: 0
linePrices:
type: array
items:
$ref: '#/components/schemas/UrlForwardingLinePrices'
UserPermissionAddedEvent:
type: object
description: New permissions added to user event.
required:
- type
properties:
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2022-12-20T15:42:37Z'
type:
type: string
example: USER_PERMISSION_ADDED
updatedUser:
type: object
description: Shows as "user" in API results. Named "updatedUser" in JDK objects.
properties:
name:
type: string
example: John Smith
cscUserName:
type: string
example: jsmith01
email:
type: string
example: john.smith@cscglobal.com
userRoles:
type: array
items:
type: string
example: Edit DNS records
VitalDomainAddedEvent:
type: object
description: Vital domain added to portfolio event.
required:
- type
properties:
domainName:
type: string
description: Domain name target of the event
example: example.com
user:
type: string
description: The user who's action generated this security event.
example: CSC SERVICE REP
ipAddress:
type: string
nullable: true
description: The IP Address of the user who triggered the event. May be null.
example: 1.1.1.1
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2019-10-03T15:42:37Z'
type:
type: string
example: VITAL_DOMAIN_ADDED
account:
$ref: '#/components/schemas/Account'
WhoisContact:
type: object
properties:
contactType:
type: string
enum:
- REGISTRANT
- ADMINISTRATIVE
- TECHNICAL
- OWNER_IF_PRIVACY_APPLIED
example: REGISTRANT
firstName:
type: string
example: John
lastName:
type: string
example: Lee
organization:
type: string
example: CSC
street1:
type: string
example: 251 Little Falls Dr
street2:
type: string
example: ''
city:
type: string
example: Wilmington
stateProvince:
type: string
example: DE
country:
type: string
example: US
postalCode:
type: string
example: '19808'
email:
type: string
example: john.lee@cscglobal.com
phone:
type: string
example: '+1.1234567890'
phoneExtn:
type: string
example: '1234'
fax:
type: string
example: '+1.1234567890'
xml:
name: whoisContacts
WhoisContactChangeRequestedEvent:
type: object
description: Whois contact change requested for domain event.
required:
- type
properties:
domainName:
type: string
description: Domain name target of the event
example: example.com
user:
type: string
description: The user who's action generated this security event.
example: CSC SERVICE REP
ipAddress:
type: string
nullable: true
description: The IP Address of the user who triggered the event. May be null.
example: 1.1.1.1
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2019-10-03T15:42:37Z'
type:
type: string
example: WHOIS_CONTACT_CHANGE_REQUESTED
account:
$ref: '#/components/schemas/Account'
whoisContacts:
properties:
adminContact:
$ref: '#/components/schemas/EventContact'
registrantContact:
$ref: '#/components/schemas/EventContact'
technicalContact:
$ref: '#/components/schemas/EventContact'
WhoisContactModRequest:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
description: This property is required
adminContactProfile:
type: string
example: WhoisContactAdmin
description: This property is required unless adding account masking
registrantContactProfile:
type: string
example: WhoisContactRegistrant
description: This property is required unless adding account masking
technicalContactProfile:
type: string
example: WhoisContactTechnical
useAccountMasking:
type: boolean
example: false
description: Use true if adding account masking. Use false if removing account masking. Otherwise do not include.
notifications:
$ref: '#/components/schemas/Notifications'
showPrice:
type: boolean
example: true
customFields:
type: array
maximum: 20
items:
$ref: '#/components/schemas/CustomField'
WhoisContactModRequestResult:
type: object
properties:
result:
type: object
properties:
qualifiedDomainName:
type: string
example: example.com
status:
type: object
properties:
code:
$ref: '#/components/schemas/nsModResultCode'
message:
type: string
example: Order has been successfully submitted
description: A message that corresponds with the response status code
additionalInformation:
type: string
example: Extension rules are missing
description: Any further details/data that is needed for the response
uuid:
type: string
example: 113b4cef-9b4d-4962-9a4e-f3186a7d12ed
price:
type: object
properties:
currency:
type: string
example: USD
total:
type: number
example: 20
linePrices:
type: array
items:
$ref: '#/components/schemas/linePricesWhoisContactMod'
WhoisContactProfile:
type: object
properties:
profileName:
type: string
example: Example Profile
firstName:
type: string
example: John
lastName:
type: string
example: Lee
organization:
type: string
example: CSC
street1:
type: string
example: 251 Little Falls Dr
street2:
type: string
example: ''
city:
type: string
example: Wilmington
stateProvince:
type: string
example: DE
country:
type: string
example: US
postalCode:
type: string
example: '19808'
email:
type: string
example: john.lee@cscglobal.com
phone:
type: string
example: '+1.1234567890'
phoneExtn:
type: string
example: '1234'
fax:
type: string
example: '+1.1234567890'
contactTypes:
type: array
items:
type: string
enum:
- REGISTRANT
- ADMINISTRATIVE
- TECHNICAL
example:
- REGISTRANT
- ADMINISTRATIVE
xml:
name: whoisContactProfiles
WhoisContactProfilePagedResource:
type: object
properties:
meta:
$ref: '#/components/schemas/Meta'
whoisContactProfiles:
type: array
items:
$ref: '#/components/schemas/WhoisContactProfile'
links:
type: object
properties:
self:
type: string
example: 'https://apis.cscglobal.com/dbs/api/v2/admin/whoiscontactprofiles'
Zone:
type: object
properties:
zoneName:
type: string
example: example.com
hostingType:
type: string
example: CSC_BASIC
a:
type: array
items:
type: object
properties:
id:
type: string
nullable: true
example: ead715400a0a0c14145c099571287184
value:
type: string
nullable: true
example: 1.2.3.4
key:
type: string
nullable: true
example: www
ttl:
type: integer
nullable: true
example: 3000
status:
type: string
nullable: true
example: ACTIVE
cname:
type: array
items:
type: object
properties:
id:
type: string
nullable: true
example: ead715400a0a0c14145c099571287185
value:
type: string
nullable: true
example: us
key:
type: string
nullable: true
example: fr
ttl:
type: integer
nullable: true
example: 3000
status:
type: string
nullable: true
example: ACTIVE
aaaa:
type: array
items:
type: object
properties:
id:
type: string
nullable: true
example: ead715400a0a0c14145c099571287186
value:
type: string
nullable: true
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9b'
key:
type: string
nullable: true
example: www
ttl:
type: integer
nullable: true
example: 3000
status:
type: string
nullable: true
example: ACTIVE
txt:
type: array
items:
type: object
properties:
id:
type: string
nullable: true
example: ead715400a0a0c14145c099571287110
value:
type: string
nullable: true
example: 'v=spf1 a mx ip4:1.2.3.4'
key:
type: string
nullable: true
example: '@'
ttl:
type: integer
nullable: true
example: 3000
status:
type: string
nullable: true
example: ACTIVE
mx:
type: array
items:
type: object
properties:
id:
type: string
nullable: true
example: ead715400a0a0c14145c099571287120
value:
type: string
nullable: true
example: mymx.cscdns.net.
key:
type: string
nullable: true
example: '@'
ttl:
type: integer
nullable: true
example: 3000
priority:
type: integer
nullable: true
example: 10
status:
type: string
nullable: true
example: ACTIVE
ns:
type: array
items:
type: object
properties:
id:
type: string
nullable: true
example: ead715400a0a0c14145c099571287123
value:
type: string
nullable: true
example: ns1.cscdns.net
key:
type: string
nullable: true
example: '@'
priority:
type: integer
nullable: true
example: 1
ttl:
type: integer
nullable: true
example: 3000
status:
type: string
nullable: true
example: ACTIVE
srv:
type: array
items:
type: object
properties:
id:
type: string
nullable: true
example: ead715400a0a0c14145c099571287123
value:
type: string
nullable: true
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9b'
key:
type: string
nullable: true
example: www
priority:
type: integer
nullable: true
example: 10
weight:
type: integer
nullable: true
example: 10
ttl:
type: integer
nullable: true
example: 3000
status:
type: string
nullable: true
example: ACTIVE
caa:
type: array
items:
type: object
properties:
id:
type: string
nullable: true
example: ead715400a0a0c14145c099571287110
value:
type: string
nullable: true
example: 'v=spf1 a mx ip4:1.2.3.4'
key:
type: string
nullable: true
example: '@'
ttl:
type: integer
nullable: true
example: 3000
status:
type: string
nullable: true
example: ACTIVE
tag:
type: string
nullable: true
example: TAG
flag:
type: integer
nullable: true
example: 200
soa:
type: object
properties:
serial:
type: integer
nullable: true
example: 2000000001
refresh:
type: integer
nullable: true
example: 25000
retry:
type: integer
nullable: true
example: 604800
expire:
type: integer
nullable: true
example: 604800
ttlMin:
type: integer
nullable: true
example: 14400
ttlNeg:
type: integer
nullable: true
example: 14400
ttlZone:
type: integer
nullable: true
example: 14400
techEmail:
type: string
nullable: true
example: hostmaster.cscdns.net.
masterHost:
type: string
nullable: true
example: dns1.cscdns.net.
ZoneEdit:
type: object
properties:
zoneName:
type: string
nullable: true
example: example.com
id:
type: string
nullable: true
example: 877c37aa-60ac-4d92-a5a4-0da64a4b3e35
zoneId:
type: string
nullable: true
example: ff545b720a5f8c8c013345fb99325520
status:
$ref: '#/components/schemas/zoneEditStatus'
modifiedDate:
type: string
nullable: true
example: 25-Mar-2020
requestedBy:
type: string
nullable: true
example: Sigma Klim
source:
type: string
nullable: true
example: API
a:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newKey:
type: string
nullable: true
example: www
newValue:
type: string
nullable: true
example: 1.2.3.4
currentKey:
type: string
nullable: true
example: '*'
currentValue:
type: string
nullable: true
example: 1.4.3.4
newTtl:
type: integer
nullable: true
example: 1000
currentTtl:
type: integer
nullable: true
example: 3000
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
cname:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newKey:
type: string
nullable: true
example: fr
newValue:
type: string
nullable: true
example: us
currentKey:
type: string
nullable: true
example: us
currentValue:
type: string
nullable: true
example: fr
newTtl:
type: integer
nullable: true
example: 3000
currentTtl:
type: integer
nullable: true
example: 3300
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
aaaa:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newKey:
type: string
nullable: true
example: www
newValue:
type: string
nullable: true
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9b'
currentKey:
type: string
nullable: true
example: www
currentValue:
type: string
nullable: true
example: '5676:94d2:3372:d5aa:dd5:f863:869b:fe9b'
newTtl:
type: integer
nullable: true
example: 3000
currentTtl:
type: integer
nullable: true
example: 3100
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
txt:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newKey:
type: string
nullable: true
example: '@'
newValue:
type: string
nullable: true
example: 'v=spf1 a mx ip4:1.2.3.4'
currentKey:
type: string
nullable: true
example: '@'
currentValue:
type: string
nullable: true
example: 'v=spf1 a mx ip4:1.2.3.5'
newTtl:
type: integer
nullable: true
example: 3000
currentTtl:
type: integer
nullable: true
example: 3008
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
mx:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newKey:
type: string
nullable: true
example: '@'
newValue:
type: string
nullable: true
example: mymx.cscdns.net.
currentKey:
type: string
nullable: true
example: '@'
currentValue:
type: string
nullable: true
example: mymx.cscdns.net.
newTtl:
type: integer
nullable: true
example: 3000
currentTtl:
type: integer
nullable: true
example: 3001
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
newPriority:
type: integer
nullable: true
example: 11
currentPriority:
type: integer
nullable: true
example: 10
ns:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newKey:
type: string
nullable: true
example: '@'
newValue:
type: string
nullable: true
example: ns1.cscdns.net
currentKey:
type: string
nullable: true
example: '@'
currentValue:
type: string
nullable: true
example: myns2.cscdns.net.
newTtl:
type: integer
nullable: true
example: 3000
currentTtl:
type: integer
nullable: true
example: 3001
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
newPriority:
type: integer
nullable: true
example: 1
currentPriority:
type: integer
nullable: true
example: 10
srv:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newKey:
type: string
nullable: true
example: www
newValue:
type: string
nullable: true
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9b'
currentKey:
type: string
nullable: true
example: www
currentValue:
type: string
nullable: true
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9c'
newTtl:
type: integer
nullable: true
example: 3000
currentTtl:
type: integer
nullable: true
example: 4000
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
newPriority:
type: integer
nullable: true
example: 10
currentPriority:
type: integer
nullable: true
example: 11
newWeight:
type: integer
nullable: true
example: 10
currentWeight:
type: integer
nullable: true
example: 11
newPort:
type: integer
nullable: true
example: 1543
currentPort:
type: integer
nullable: true
example: 1544
caa:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newKey:
type: string
nullable: true
example: www
newValue:
type: string
nullable: true
example: caa.rec
currentKey:
type: string
nullable: true
example: www
currentValue:
type: string
nullable: true
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9c'
newTtl:
type: integer
nullable: true
example: 3000
currentTtl:
type: integer
nullable: true
example: 4000
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
newTag:
type: string
nullable: true
example: TAG
currentTag:
type: string
nullable: true
example: OLDTAG
newFlag:
type: integer
nullable: true
example: 42
currentFlag:
type: integer
nullable: true
example: 40
soa:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
newRefresh:
type: integer
nullable: true
example: 25000
currentRefresh:
type: integer
nullable: true
example: 25000
newRetry:
type: integer
nullable: true
example: 604800
currentRetry:
type: integer
nullable: true
example: 604800
newExpire:
type: integer
nullable: true
example: 604800
currentExpire:
type: integer
nullable: true
example: 604800
newTtlMin:
type: integer
nullable: true
example: 14400
currentTtlMin:
type: integer
nullable: true
example: 14400
comments:
type: string
nullable: true
example: a comment about the cname record edit
changeId:
type: string
nullable: true
example: change 123
action:
type: string
enum:
- ADD
- EDIT
- PURGE
- ACTIVATE
- DEACTIVATE
example: EDIT
ZoneEditRequest:
type: object
properties:
zoneName:
type: string
example: api-testing-post-zoneedits.com
edits:
type: array
items:
$ref: '#/components/schemas/zoneResourceRecordEdit'
required:
- zoneName
- edits
ZoneEditRequestedEvent:
type: object
description: Zone edit request event.
required:
- type
properties:
zoneName:
type: string
description: Zone name target of the event
example: example.com
requestedBy:
type: string
description: The user who requested this change.
example: Sigma Klim
user:
type: string
description: The user who's action generated this security event.
example: CSC SERVICE REP
ipAddress:
type: string
nullable: true
description: The IP Address of the user who triggered the event. May be null.
example: 1.1.1.1
date:
type: string
description: The date-time when the security event occurred. UTC timezone and ISO-standard format.
example: '2019-10-03T15:42:37Z'
type:
type: string
example: ZONE_EDIT_REQUESTED
account:
$ref: '#/components/schemas/Account'
records:
type: object
properties:
a:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
key:
type: string
example: www
value:
type: string
example: 1.2.3.4
previousKey:
type: string
nullable: true
example: '*'
previousValue:
type: string
nullable: true
example: 1.4.3.4
ttl:
type: integer
nullable: true
example: 1000
previousTtl:
type: integer
nullable: true
example: 3000
cname:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
key:
type: string
example: fr
value:
type: string
example: us
previousKey:
type: string
nullable: true
example: us
previousValue:
type: string
nullable: true
example: fr
ttl:
type: integer
nullable: true
example: 3000
previousTtl:
type: integer
nullable: true
example: 3300
aaaa:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
value:
type: string
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9b'
key:
type: string
example: www
previousKey:
type: string
nullable: true
example: www
previousValue:
type: string
nullable: true
example: '5676:94d2:3372:d5aa:dd5:f863:869b:fe9b'
ttl:
type: integer
nullable: true
example: 3000
previousTtl:
type: integer
nullable: true
example: 3100
txt:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
key:
type: string
example: '@'
value:
type: string
example: 'v=spf1 a mx ip4:1.2.3.4'
previousKey:
type: string
nullable: true
example: '@'
previousValue:
type: string
nullable: true
example: 'v=spf1 a mx ip4:1.2.3.5'
ttl:
type: integer
nullable: true
example: 3000
previousTtl:
type: integer
nullable: true
example: 3008
mx:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
key:
type: string
example: '@'
value:
type: string
example: mymx.cscdns.net.
previousKey:
type: string
nullable: true
example: '@'
previousValue:
type: string
nullable: true
example: mymx.cscdns.net.
ttl:
type: integer
nullable: true
example: 3000
previousTtl:
type: integer
nullable: true
example: 3001
priority:
type: integer
nullable: true
example: 11
previousPriority:
type: integer
nullable: true
example: 10
ns:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
key:
type: string
example: '@'
value:
type: string
example: ns1.cscdns.net
previousKey:
type: string
nullable: true
example: '@'
previousValue:
type: string
nullable: true
example: myns2.cscdns.net.
ttl:
type: integer
nullable: true
example: 3000
previousTtl:
type: integer
nullable: true
example: 3001
priority:
type: integer
nullable: true
example: 1
previousPriority:
type: integer
nullable: true
example: 10
srv:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
key:
type: string
example: www
value:
type: string
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9b'
previousKey:
type: string
example: www
previousValue:
type: string
nullable: true
example: '5674:94d2:3372:d5aa:dd5:f863:869b:fe9c'
priority:
type: integer
nullable: true
example: 10
previousPriority:
type: integer
nullable: true
example: 11
ttl:
type: integer
nullable: true
example: 3000
previousTtl:
type: integer
nullable: true
example: 4000
weight:
type: integer
nullable: true
example: 10
previousWeight:
type: integer
nullable: true
example: 11
soa:
type: array
items:
type: object
properties:
action:
$ref: '#/components/schemas/action'
refresh:
type: integer
example: 25000
previousRefresh:
type: integer
nullable: true
example: 25000
retry:
type: integer
example: 604800
previousRetry:
type: integer
nullable: true
example: 604800
expire:
type: integer
example: 604800
previousExpire:
type: integer
nullable: true
example: 604800
ttlMin:
type: integer
example: 14400
previousTtlMin:
type: integer
nullable: true
example: 14400
ZoneEditRequestResult:
type: object
properties:
content:
type: object
properties:
status:
$ref: '#/components/schemas/publishJobResultCode'
message:
type: string
example: Sample message
links:
$ref: '#/components/schemas/PublishLinks'
zoneEditStatus:
type: string
enum:
- NEW
- SAVED
- SUBMITTED
- PROCESSING
- COMPLETED
- COMPLETE
- CANCELED
- AWAITING_APPROVAL
- REJECTED
- PROPAGATING
- PROPAGATING_FAILED
- FAILED
example: SUBMITTED
ZoneEditStatusLinksNoEditsRequired:
type: object
properties:
status:
type: string
example: Forwarding already exists. No zone edits required.
ZoneEditStatusResult:
type: object
properties:
content:
type: object
properties:
status:
$ref: '#/components/schemas/zoneEditStatus'
links:
$ref: '#/components/schemas/EditStatusLinks'
zoneResourceRecordEdit:
type: object
description: General record with fields that span all zone record types for all actions. For any given request not all of the fields need to be populated or present.
required:
- recordType
- action
properties:
recordType:
$ref: '#/components/schemas/resourceRecordType'
action:
$ref: '#/components/schemas/action'
currentKey:
type: string
nullable: true
example: '@'
currentValue:
type: string
nullable: true
example: '*.123-test-csc.guru.'
newKey:
type: string
nullable: true
example: '@'
newValue:
type: string
nullable: true
example: www.123-test-csc.guru
newTtl:
type: number
nullable: true
example: 5400
currentTtl:
type: number
nullable: true
example: 3600000
newPriority:
type: number
description: Only used for EDIT actions of MX and SRV records to update an existing record.
nullable: true
example: (Not used on CNAME Record Edit Requests.)
currentPriority:
type: number
description: Used in MX and SRV record to determine the order in which servers in the currentValue are accessed.
nullable: true
example: (Not used on CNAME Record Edit Requests.)
newWeight:
type: number
description: 'Only used during EDIT or ADD actions on the SRV type zone records, this value will update the currentWeight value.'
nullable: true
example: 10
currentWeight:
type: number
description: Only used to identify an existing SRV record.
nullable: true
example: (Not used on CNAME Record Edit Requests.)
newTag:
type: string
description: Only used during EDIT or ADD actions on SRV type records.
nullable: true
example: (Not used on CNAME Record Edit Requests.)
currentTag:
type: string
description: Used to identify an existing SRV record.
nullable: true
example: (Not used on CNAME Record Edit Requests.)
newFlag:
type: number
description: Only used on CAA records.
nullable: true
example: (Not used on CNAME Record Edit Requests.)
currentFlag:
type: number
description: 'CAA records only, Used to identify an existing CAA record.'
nullable: true
example: (Not used on CNAME Record Edit Requests.)
newPort:
type: number
description: SRV only.
nullable: true
example: (Not used on CNAME Record Edit Requests.)
currentPort:
type: number
description: SRV only.
nullable: true
example: (Not used on CNAME Record Edit Requests.)
changeId:
type: string
nullable: true
example: update 01-18-2022.1
description: 'A customer provided id of less than 50 characters, use to associate this zone edit with relevant data in the customers systems.'
comments:
type: string
description: Holds a customer provided memo of less than 500 bytes to document this zone edit.
nullable: true
example: A comment about this change