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