{
"openapi": "3.0.1",
"info": {
"title": "EuroDNS User API",
"version": "1.0.0",
"x-logo": {
"url": "https://cdn.eurodns.com/images/showcase/assets/LOGO-WHITE-BG.png",
"altText": "Logo"
},
"description": "**Authentication:** API requires `X-APP-ID` and `X-API-KEY` headers for all requests.\n\n## Example Request\n\n```bash\ncurl -X GET \"https://rest-api.eurodns.com/domains/example.com\" \\\n-H \"X-APP-ID: your-app-id\" \\\n-H \"X-API-KEY: your-api-key\" \\\n-H \"Content-Type: application/json\"\n```\n\n## Security Policy\n\n| Policy | Details |\n|---|---|\n| **IP Whitelisting** | Configurable via your account dashboard |\n| **Rate Limit** | 10 requests per 10 seconds per IP |\n| **Rate Limit Violations** | Progressive banning with increasing duration |\n\n> **Important**: Each rate limit violation during a ban period extends the ban duration.",
"contact": {
"name": "EuroDNS API Support",
"email": "support@eurodns.com"
},
"summary": "The EuroDNS User API provides programmatic access to domain management services, DNS configuration, and subscription management. This RESTful API enables developers to integrate EuroDNS services directly into their applications and workflows."
},
"servers": [
{
"url": "https://rest-api.eurodns.com"
}
],
"security": [
{
"X-APP-ID": [
],
"X-API-KEY": [
]
}
],
"tags": [
{
"name": "DasService",
"x-displayName": "Domains Availability"
},
{
"name": "TldService",
"x-displayName": "Top-Level Domains"
},
{
"name": "DnsProvider",
"x-displayName": "DNS Zones"
},
{
"name": "ContactProfileService",
"x-displayName": "Contact Profiles"
},
{
"name": "NameserverProfileService",
"x-displayName": "Nameserver Profiles"
},
{
"name": "ContactValidationService",
"x-displayName": "Contact Validation"
},
{
"name": "SubscriptionService",
"x-displayName": "Subscriptions"
},
{
"name": "SslSubscriptionService",
"x-displayName": "SSL subscriptions"
},
{
"name": "EmailSubscriptionService",
"x-displayName": "Email subscriptions"
},
{
"name": "PremiumDnsSubscriptionService",
"x-displayName": "Premium DNS subscriptions"
},
{
"name": "MicrosoftSubscriptionService",
"x-displayName": "Microsoft subscriptions"
},
{
"name": "DomainService",
"description": "UserApiDomainService"
},
{
"name": "HttpsRedirectService"
}
],
"paths": {
"/dns-zones/{domain-name}": {
"get": {
"tags": [
"DnsProvider"
],
"summary": "Get DNS Zone",
"description": "Returns a DNS Zone with its DNS records, URL forwards and mail forwards.
You may then make changes (e.g. adding, updating and removing records) to the DNS Zone and use it with the Validate or Save operations.",
"operationId": "getDnsZone",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "a domain name (e.g. example.com)",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DnsZonePage"
}
}
}
}
}
},
"put": {
"tags": [
"DnsProvider"
],
"summary": "Save DNS Zone",
"description": "Takes a DNS Zone and Save any changes on DNS records.
If the changes made to the DNS Zone are not valid, the operation replies with a 400 Bad Request. Use the Validate operation to get a detailed Validation report.",
"operationId": "saveDnsZone",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "a domain name (e.g. example.com)",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DnsZonePage"
}
}
},
"required": true
},
"responses": {
"204": {
"description": "No Content"
}
}
}
},
"/dns-zones/{domain-name}/check": {
"post": {
"tags": [
"DnsProvider"
],
"summary": "Validate DNS Zone",
"description": "Takes a DNS zone and validate any changes on DNS records, URL forwards and mail forwards.
Returns the updated DNS Zone with a detailed Validation report.
This operation does not apply any changes made to the DNS Zone, use the Save operation instead.",
"operationId": "checkDnsZone",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "a domain name (e.g. example.com)",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DnsZonePage"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DnsZonePage"
}
}
}
}
}
}
},
"/dns-zones/{domain-name}/snapshots": {
"get": {
"tags": [
"DnsProvider"
],
"summary": "List DNS Zone Snapshots",
"operationId": "listDnsZoneSnapshots",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "a domain name (e.g. example.com)",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DnsZoneSnapshotItem"
}
}
}
}
}
}
}
},
"/dns-zones/{domain-name}/snapshots/{id}": {
"get": {
"tags": [
"DnsProvider"
],
"summary": "Get DNS Zone Snapshot ",
"operationId": "getSnapShot",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "a domain name (e.g. example.com)",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "id",
"in": "path",
"description": "id of Zone Snapshot to return",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DnsZoneSnapshotPage"
}
}
}
}
}
}
},
"/dns-zones/{domain-name}/dnssec-status": {
"get": {
"tags": [
"DnsProvider"
],
"summary": "Get DNS Zone DNSSEC status",
"description": "Returns the current DNSSEC Status of a DNS Zone. If zone is signed, the DNSSEC keys will be returned as well.",
"operationId": "getDnssecStatus",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "a domain name (e.g. example.com)",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DnsZoneDnssecStatus"
}
}
}
}
}
}
},
"/dns-zones/{domain-name}/dns-records": {
"post": {
"tags": [
"DnsProvider"
],
"summary": "Add DNS records",
"description": "Add one or more DNS records to the zone and save the changes.",
"operationId": "addDnsRecords",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "a domain name (e.g. example.com)",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DnsRecord"
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DnsZonePage"
}
}
}
}
}
}
},
"/dns-zones/{domain-name}/dns-records/{record-id}": {
"delete": {
"tags": [
"DnsProvider"
],
"summary": "Delete a DNS record",
"description": "Delete a DNS record from the zone and save the changes.",
"operationId": "deleteDnsRecord",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "a domain name (e.g. example.com)",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "record-id",
"in": "path",
"description": "a Dns record id",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DnsZonePage"
}
}
}
}
}
}
},
"/dns-zones/{domain-name}/sign": {
"post": {
"tags": [
"DnsProvider"
],
"summary": "Sign DNS Zone",
"description": "Sign DNS Zone. If the domain is registered with us, please sign the domain instead using the appropriate command.",
"operationId": "signZone",
"parameters": [
{
"name": "domain-name",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "No Content"
}
}
}
},
"/dns-zones/{domain-name}/unsign": {
"post": {
"tags": [
"DnsProvider"
],
"summary": "Unsign DNS Zone",
"description": "Unsign DNS Zone. If the domain is registered with us, please unsign the domain instead using the appropriate command.",
"operationId": "unsignZone",
"parameters": [
{
"name": "domain-name",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "No Content"
}
}
}
},
"/zone-profiles": {
"get": {
"tags": [
"DnsProvider"
],
"summary": "List DNS Zone Profiles",
"operationId": "listZoneProfiles",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"description": "Page number for Pagination",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"description": "Number of results per page for Pagination. If pagination-size = -1, results are returned in one page",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"description": "Field name for result sorting",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"enum": [
"id",
"name"
]
}
},
{
"name": "pagination-sortorder",
"in": "header",
"description": "Field Sort direction",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
{
"name": "name",
"in": "query",
"description": "zone profile name",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"headers": {
"pagination-page": {
"description": "The current page number",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-size": {
"description": "The number of items per page",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-count": {
"description": "The total number of items",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-sortfield": {
"description": "The field used for sorting",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"enum": [
"id",
"name"
]
}
},
"pagination-sortorder": {
"description": "The sort order",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ZoneProfile"
}
}
}
}
}
}
},
"post": {
"tags": [
"DnsProvider"
],
"summary": "Create DNS Zone Profile",
"operationId": "createZoneProfile",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ZoneProfilePage"
}
}
},
"required": true
},
"responses": {
"201": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ZoneProfilePage"
}
}
}
}
}
}
},
"/zone-profiles/{id}": {
"get": {
"tags": [
"DnsProvider"
],
"summary": "Get DNS Zone Profile",
"operationId": "getProfile",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id of zone profile to return",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ZoneProfilePage"
}
}
}
}
}
},
"put": {
"tags": [
"DnsProvider"
],
"summary": "Save DNS Zone Profile",
"operationId": "updateUserAPiZoneProfile",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id of zone profile to update",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ZoneProfilePage"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ZoneProfilePage"
}
}
}
}
}
},
"delete": {
"tags": [
"DnsProvider"
],
"summary": "Delete DNS Zone Profile",
"operationId": "deleteZoneProfile",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id of zone profile to delete",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"204": {
"description": "No Content"
}
}
}
},
"/zone-profiles/check": {
"post": {
"tags": [
"DnsProvider"
],
"summary": "Validate DNS Zone Profile",
"operationId": "checkZoneProfile",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ZoneProfilePage"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ZoneProfilePage"
}
}
}
}
}
}
},
"/domains/{domain-name}/sign": {
"post": {
"tags": [
"DomainService"
],
"summary": "Sign domain",
"operationId": "signDomain",
"parameters": [
{
"name": "domain-name",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "No Content"
}
}
}
},
"/domains/{domain-name}/unsign": {
"post": {
"tags": [
"DomainService"
],
"summary": "Unsign domain",
"operationId": "unsignDomain",
"parameters": [
{
"name": "domain-name",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "No Content"
}
}
}
},
"/domains/{domain-name}": {
"get": {
"tags": [
"DomainService"
],
"summary": "Get domain",
"description": "Get a domain by name",
"operationId": "getDomain",
"parameters": [
{
"name": "domain-name",
"in": "path",
"description": "The exact domain name",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Domain"
}
}
}
}
}
}
},
"/domains/search": {
"post": {
"tags": [
"DomainService"
],
"summary": "Search domains",
"description": "Search domains with a search term and search filters",
"operationId": "searchDomains",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"description": "Page number for Pagination",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"description": "Number of results per page for Pagination. If pagination-size = -1, results are returned in one page",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"description": "Field name for result sorting",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"enum": [
"CREATION_DATE",
"DOMAIN_NAME",
"EXPIRATION_DATE",
"FOLDER",
"LAST_UPDATE_DATE",
"REACTIVATE_UNTIL",
"RENEWABLE_FROM",
"RENEWABLE_UNTIL",
"RENEWAL_METHOD",
"TLD_NAME"
]
}
},
{
"name": "pagination-sortorder",
"in": "header",
"description": "Field Sort direction",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"enum": [
"asc",
"desc"
]
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DomainSearchRequest"
}
}
}
},
"responses": {
"200": {
"description": "OK",
"headers": {
"pagination-page": {
"description": "The current page number",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-size": {
"description": "The number of items per page",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-count": {
"description": "The total number of items",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-sortfield": {
"description": "The field used for sorting",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
"pagination-sortorder": {
"description": "The sort order",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DomainSearchResult"
}
}
}
}
}
}
}
},
"/tlds/{id}": {
"get": {
"tags": [
"TldService"
],
"summary": "Get a TLD",
"description": "Takes an `id` of TLD.
Returns a TLD which contains all information relative to the TLD matching the specified `id`.",
"operationId": "getTld",
"parameters": [
{
"name": "id",
"in": "path",
"description": "id of TLD to return",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "TLD which has the specified ID",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Tld"
}
}
}
},
"default": {
"description": "Error message relative to TLD retrieving",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/tlds": {
"get": {
"tags": [
"TldService"
],
"summary": "List TLDs",
"description": "Takes filters (`tld-name`).
Returns a list of TLDs (matching specified filters) which each contains all information relative to the TLD.",
"operationId": "listTld",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"description": "Page number for Pagination",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"description": "Number of results per page for Pagination. If pagination-size = -1, results are returned in one page",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "tld-name",
"in": "query",
"description": "filter by TLD name",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "List of all TLDs matching specified filters",
"headers": {
"pagination-page": {
"description": "The current page number",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-size": {
"description": "The number of items per page",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-count": {
"description": "The total number of items",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
"pagination-sortfield": {
"description": "The field used for sorting",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
"pagination-sortorder": {
"description": "The sort order",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Tld"
}
}
}
}
},
"default": {
"description": "Error message relative to TLD list retrieving",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/contact-profiles": {
"get": {
"tags": [
"ContactProfileService"
],
"summary": "List contact profiles",
"description": "Get a list of contact profiles matching specified optional filters.",
"operationId": "getContactProfiles",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "pagination-sortorder",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"$ref": "#/components/schemas/SortOrder"
}
},
{
"name": "type",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"$ref": "#/components/schemas/ContactType"
}
},
{
"name": "is-org",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean"
}
},
{
"name": "is-admin",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean"
}
},
{
"name": "is-tech",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean"
}
},
{
"name": "is-billing",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Successful response returning a list of matching contact profiles.",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ContactProfile"
}
}
}
}
}
}
},
"post": {
"tags": [
"ContactProfileService"
],
"summary": "Create a contact profile",
"description": "Create a new contact profile with given input data.",
"operationId": "createContactProfile",
"parameters": [
{
"name": "lang",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "Data of the Contact profile to create.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContactProfile"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Successful response returning the created contact profile with it's assigned ID.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContactProfile"
}
}
}
}
}
}
},
"/contact-profiles/{id}": {
"get": {
"tags": [
"ContactProfileService"
],
"summary": "Get a contact profile",
"description": "Get all information relative to the contact profile with specified ID.",
"operationId": "getContactProfile",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Successful response returning the contact profile details.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContactProfile"
}
}
}
}
}
},
"put": {
"tags": [
"ContactProfileService"
],
"summary": "Update a contact profile",
"description": "Update changes on the corresponding contact profile.
All fields should be given even if value not changed, otherwise it will be considered as empty value if allowed.",
"operationId": "updateContactProfile",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "lang",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "Data of the Contact profile to update.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContactProfile"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Successful response returning the updated contact profile details.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContactProfile"
}
}
}
}
}
},
"delete": {
"tags": [
"ContactProfileService"
],
"summary": "Delete a contact profile",
"description": "Delete the specified contact profile.",
"operationId": "deleteContactProfile",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Deletion success"
}
}
}
},
"/contact-profiles/{id}/default-status": {
"put": {
"tags": [
"ContactProfileService"
],
"summary": "Set contact profile default states.",
"description": "Set the specified contact profile as default contact for the types specified in the request body.",
"operationId": "setAsDefaultContactProfile",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"description": "True flags for all wanted contact types for which the contact profile should be the default one. All fields are optional, only put a TRUE boolean value on the ones you want.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContactProfileDefaultStatus"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Successful response returning the current applied contact profile default status.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ContactProfileDefaultStatus"
}
}
}
}
}
}
},
"/nameserver-profiles": {
"get": {
"tags": [
"NameserverProfileService"
],
"summary": "List nameserver profiles",
"description": "Get a list of nameserver profiles matching specified optional filters.",
"operationId": "getNameserverProfiles",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "pagination-sortorder",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"$ref": "#/components/schemas/SortOrder"
}
},
{
"name": "default",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean"
}
},
{
"name": "deletable",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean"
}
},
{
"name": "include-nameservers",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/NameserverProfile"
}
}
}
}
}
}
},
"post": {
"tags": [
"NameserverProfileService"
],
"summary": "Create a nameserver profile",
"description": "Create a new nameserver profile with given input data.",
"operationId": "createNameserverProfile",
"parameters": [
{
"name": "lang",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NameserverProfile"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NameserverProfile"
}
}
}
}
}
}
},
"/nameserver-profiles/{id}": {
"get": {
"tags": [
"NameserverProfileService"
],
"summary": "Get a nameserver profile",
"description": "Get all information relative to the nameserver profile with specified ID.",
"operationId": "getNameserverProfile",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NameserverProfile"
}
}
}
}
}
},
"put": {
"tags": [
"NameserverProfileService"
],
"summary": "Update a nameserver profile",
"description": "Update changes on the corresponding nameserver profile.
All fields should be given even if value not changed, otherwise it will be considered as empty value if allowed.",
"operationId": "updateNameserverProfile",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "lang",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NameserverProfile"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NameserverProfile"
}
}
}
}
}
},
"delete": {
"tags": [
"NameserverProfileService"
],
"summary": "Delete a nameserver profile",
"description": "Delete the specified nameserver profile.",
"operationId": "deleteNameserverProfile",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Success"
}
}
}
},
"/das/available-domain-names": {
"post": {
"tags": [
"DasService"
],
"summary": "Get domains availability",
"description": "Takes a list of domain names to check and get them back with each domain name current availability state.",
"operationId": "getAvailabilities",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/GetDomainsAvailability"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DomainsAvailability"
}
}
}
}
}
}
}
},
"/email-subscriptions": {
"get": {
"tags": [
"EmailSubscriptionService"
],
"summary": "Search for email subscriptions",
"description": "Get email subscriptions matching search parameters",
"operationId": "getEmailSubscriptions",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "pagination-sortorder",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"$ref": "#/components/schemas/SortOrder"
}
},
{
"name": "subscription-status",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"$ref": "#/components/schemas/SubscriptionStatus"
}
},
{
"name": "domain-name",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string",
"description": "The domain name the email subscription(s) you search for are related to"
}
},
{
"name": "user-name",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailSubscription"
}
}
}
}
}
}
}
},
"/email-subscriptions/{id}/aliases/{alias}": {
"post": {
"tags": [
"EmailSubscriptionService"
],
"summary": "Create mailbox alias",
"description": "Create an alias of the mailbox attached to the given email subscription",
"operationId": "createAlias",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "alias",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmailSubscription"
}
}
}
}
}
},
"delete": {
"tags": [
"EmailSubscriptionService"
],
"summary": "Delete mailbox alias",
"description": "Delete an alias of the mailbox attached to the given email subscription",
"operationId": "deleteAlias",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "alias",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmailSubscription"
}
}
}
}
}
}
},
"/premium-dns-subscriptions": {
"get": {
"tags": [
"PremiumDnsSubscriptionService"
],
"summary": "Search for Premium DNS subscriptions",
"description": "Search and return the Premium DNS subscriptions matching the given search parameters",
"operationId": "getPremiumDnsSubscriptions",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "pagination-sortorder",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"$ref": "#/components/schemas/SortOrder"
}
},
{
"name": "subscription-status",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"$ref": "#/components/schemas/SubscriptionStatus"
}
},
{
"name": "domain-name",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string",
"description": "The domain name the Premium DNS subscription(s) you search for are related to"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PremiumDnsSubscription"
}
}
}
}
}
}
}
},
"/premium-dns-subscriptions/{subscription-id}": {
"get": {
"tags": [
"PremiumDnsSubscriptionService"
],
"summary": "Get Premium DNS subscription details",
"description": "Get the Premium DNS subscription with given ID.",
"operationId": "getPremiumDnsSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PremiumDnsSubscription"
}
}
}
}
}
},
"delete": {
"tags": [
"PremiumDnsSubscriptionService"
],
"summary": "Delete Premium DNS subscription",
"description": "Schedule the deletion of the Premium DNS subscription with given ID.",
"operationId": "deletePremiumDnsSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PremiumDnsSubscription"
}
}
}
}
}
}
},
"/premium-dns-subscriptions/create": {
"post": {
"tags": [
"PremiumDnsSubscriptionService"
],
"summary": "Create a Premium DNS subscription",
"description": "Order the provisioning of a Premium DNS subscription.",
"operationId": "createPremiumDnsSubscription",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreatePremiumDnsSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PremiumDnsSubscription"
}
}
}
}
}
}
},
"/premium-dns-subscriptions/{subscription-id}/renew": {
"post": {
"tags": [
"PremiumDnsSubscriptionService"
],
"summary": "Renew a Premium DNS subscription",
"description": "Order the renewal of a Premium DNS subscription.",
"operationId": "renewPremiumDnsSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RenewPremiumDnsSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PremiumDnsSubscription"
}
}
}
}
}
}
},
"/premium-dns-subscriptions/{subscription-id}/upgrade": {
"post": {
"tags": [
"PremiumDnsSubscriptionService"
],
"summary": "Upgrade Premium DNS subscription",
"description": "Upgrade the Premium DNS subscription with given ID.",
"operationId": "upgradePremiumDnsSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpgradePremiumDnsSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PremiumDnsSubscription"
}
}
}
}
}
}
},
"/premium-dns-subscriptions/{subscription-id}/downgrade": {
"post": {
"tags": [
"PremiumDnsSubscriptionService"
],
"summary": "Downgrade Premium DNS subscription",
"description": "Downgrade the Premium DNS subscription with given ID.",
"operationId": "downgradePremiumDnsSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DowngradePremiumDnsSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PremiumDnsSubscription"
}
}
}
}
}
}
},
"/subscriptions": {
"get": {
"tags": [
"SubscriptionService"
],
"summary": "Search for subscriptions",
"description": "Search for subscriptions according to search parameters",
"operationId": "getSubscriptions",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "pagination-sortorder",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"$ref": "#/components/schemas/SortOrder"
}
},
{
"name": "subscription-status",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"$ref": "#/components/schemas/SubscriptionStatus"
}
},
{
"name": "subscription-types",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SubscriptionType"
}
}
},
{
"name": "domain-name",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string",
"description": "The domain name the subscription(s) you search for are related to"
}
},
{
"name": "auto-renew-enabled",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Subscription"
}
}
}
}
}
}
}
},
"/ssl-subscriptions": {
"get": {
"tags": [
"SslSubscriptionService"
],
"summary": "Search SSL subscriptions",
"description": "Get SSL subscriptions matching search parameters.",
"operationId": "getSslSubscriptions",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "pagination-sortorder",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"$ref": "#/components/schemas/SortOrder"
}
},
{
"name": "subscription-status",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"$ref": "#/components/schemas/SubscriptionStatus"
}
},
{
"name": "common-name",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string",
"description": "The common name of an SSL certificate of the subscription."
}
},
{
"name": "san-name",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string",
"description": "The SAN name of an SSL certificate of the subscription."
}
},
{
"name": "renewable",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "boolean",
"description": "The renewal capacity of the SSL subscription."
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SslSubscription"
}
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}": {
"get": {
"tags": [
"SslSubscriptionService"
],
"summary": "Get an SSL subscription",
"description": "Get the detailed data of an SSL subscription.
",
"operationId": "getSslSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error
403: FORBIDDEN_ACTION - You do not have access to this subscription.
404: SUBSCRIPTION_DELETED - Your subscription has been deleted.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslSubscription"
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}/ssl-certificates/{certificate-id}": {
"get": {
"tags": [
"SslSubscriptionService"
],
"summary": "Get an SSL certificate",
"description": "Get the detailed data of an SSL certificate.",
"operationId": "getSslCertificate",
"parameters": [
{
"name": "certificate-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error
403: FORBIDDEN_ACTION - You do not have access to this certificate.
404: CERTIFICATE_DELETED - Your certificate has been deleted.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslCertificate"
}
}
}
}
}
}
},
"/ssl-subscriptions/create": {
"post": {
"tags": [
"SslSubscriptionService"
],
"summary": "Create an SSL subscription",
"description": "Order the provisioning of an SSL subscription.",
"operationId": "createSslSubscription",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateSslSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslSubscription"
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}/renew": {
"post": {
"tags": [
"SslSubscriptionService"
],
"summary": "Renew an SSL subscription",
"description": "Order the renewal of an SSL subscription.",
"operationId": "renewSslSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RenewSslSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslSubscription"
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}/upgrade-quantity": {
"post": {
"tags": [
"SslSubscriptionService"
],
"summary": "Upgrade the SAN quantity of a multi-domain SSL subscription",
"description": "Order the quantity upgrade of an existing SSL subscription.
At least one of the san quantity field must be provided and be positive.
The subscription total SAN quantity cannot exceed 250.
This operation is only allowed for multi-domain products.",
"operationId": "upgradeSslSubscriptionQuantity",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpgradeSslSubscriptionQuantity"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslSubscription"
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}/ssl-certificates/{certificate-id}/reissue": {
"post": {
"tags": [
"SslSubscriptionService"
],
"summary": "Reissue an SSL certificate",
"description": "Reissue an SSL certificate of the provided subscription.",
"operationId": "reissueSslCertificate",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "certificate-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ReissueSslSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslCertificate"
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}/ssl-certificates/{certificate-id}/sans/{san-name}/validation": {
"get": {
"tags": [
"SslSubscriptionService"
],
"summary": "Get the validation information of an SSL certificate",
"description": "Get the validation data needed to validate the SSL certificate SAN of given subscription.",
"operationId": "getSslValidation",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "certificate-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "san-name",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslValidation"
},
"examples": {
"URL": {
"summary": "URL validation",
"value": {
"allowedApprovers": [
"example.com"
],
"approver": "http://example.com",
"fileValidationUrls": [
"http://example.com/.well-known/pki-validation/F1F451D015E4E4E3C669303F43347176.txt"
],
"securityToken": "BD0C5C0DAB1C8C852F2BABC64D7D23BB419769C216526B6B95F6D505B9B78EAF\nsectigo.com\n.79zaxiy0bwjnpcgqlsgt",
"sslVerificationMethod": "URL",
"sslVerificationStatus": "PENDING"
}
},
"DNS": {
"summary": "DNS validation",
"value": {
"allowedApprovers": [
"example.com",
"www.example.com"
],
"approver": "example.com",
"securityToken": "_f1f451d015e4e4e3c669303f43347176.example.com CNAME bd0c5c0dab1c8c852f2babc64d7d23bb.419769c216526b6b95f6d505b9b78eaf.79zaxiy0bwjnpcgqlsgt.comodoca.com.",
"sslVerificationMethod": "DNS",
"sslVerificationStatus": "NOT_VERIFIED"
}
},
"EMAIL": {
"summary": "EMAIL validation",
"value": {
"allowedApprovers": [
"admin@www.example.com",
"administrator@www.example.com",
"hostmaster@www.example.com",
"postmaster@www.example.com",
"webmaster@www.example.com",
"admin@example.com",
"administrator@example.com",
"hostmaster@example.com",
"postmaster@example.com",
"webmaster@example.com"
],
"approver": "webmaster@www.example.com",
"sslVerificationMethod": "EMAIL",
"sslVerificationStatus": "VERIFIED"
}
}
}
}
}
}
}
},
"put": {
"tags": [
"SslSubscriptionService"
],
"summary": "Update the validation information of an SSL certificate",
"description": "Update the validation method and approver used to validate the SSL certificate SAN of given subscription.",
"operationId": "updateSslValidationApprover",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "certificate-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "san-name",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslValidationApprover"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslValidation"
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}/ssl-certificates/{certificate-id}/sans/{san-name}/resend-validation-email": {
"post": {
"tags": [
"SslSubscriptionService"
],
"summary": "Resend the SSL certificate validation email",
"description": "Resend the validation email used to validate the SSL certificate SAN of given subscription.",
"operationId": "resendSslApproverEmail",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "certificate-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "san-name",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"204": {
"description": "Success"
}
}
}
},
"/ssl-subscriptions/{subscription-id}/ssl-certificates/{certificate-id}/cancel": {
"post": {
"tags": [
"SslSubscriptionService"
],
"summary": "Cancel an SSL certificate validation process",
"description": "Cancel the validation of a pending SSL certificate of the provided subscription.",
"operationId": "cancelSslCertificate",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "certificate-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslCertificate"
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}/ssl-certificates/{certificate-id}/sans/{san-name}/cancel": {
"post": {
"tags": [
"SslSubscriptionService"
],
"summary": "Cancel an SSL certificate SAN validation process",
"description": "Cancel the SSL certificate SAN of the provided subscription. It will be deleted from the certificate.",
"operationId": "cancelSslSan",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "certificate-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "san-name",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslCertificate"
}
}
}
}
}
}
},
"/ssl-subscriptions/{subscription-id}/ssl-certificates/{certificate-id}/revoke": {
"post": {
"tags": [
"SslSubscriptionService"
],
"summary": "Revoke an SSL certificate",
"description": "Revoke an SSL certificate of the provided subscription.",
"operationId": "revokeSslCertificate",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "certificate-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SslCertificate"
}
}
}
}
}
}
},
"/microsoft-subscriptions": {
"get": {
"tags": [
"MicrosoftSubscriptionService"
],
"summary": "Search for microsoft subscriptions",
"description": "Get microsoft subscriptions matching search parameters",
"operationId": "getMicrosoftSubscriptions",
"parameters": [
{
"name": "pagination-page",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-size",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pagination-sortfield",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"type": "string"
}
},
{
"name": "pagination-sortorder",
"in": "header",
"required": false,
"style": "simple",
"explode": false,
"schema": {
"$ref": "#/components/schemas/SortOrder"
}
},
{
"name": "subscription-status",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"$ref": "#/components/schemas/SubscriptionStatus"
}
},
{
"name": "microsoft-domain",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string",
"description": "The domain name the microsoft subscription(s) you search for are related to"
}
},
{
"name": "account-label",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string",
"description": "The account label the microsoft subscription(s) you search for are related to"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MicrosoftSubscription"
}
}
}
}
}
}
}
},
"/microsoft-subscriptions/{id}": {
"get": {
"tags": [
"MicrosoftSubscriptionService"
],
"summary": "Get current details of a microsoft subscription",
"description": "Get microsoft subscription from its ID",
"operationId": "getMicrosoftSubscription",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MicrosoftSubscription"
}
}
}
}
}
}
},
"/email-subscriptions/{id}": {
"get": {
"tags": [
"EmailSubscriptionService"
],
"summary": "Get current details of an email subscription",
"description": "Get email subscription from its ID",
"operationId": "getEmailSubscription",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmailSubscription"
}
}
}
}
}
},
"delete": {
"tags": [
"EmailSubscriptionService"
],
"summary": "Delete an email subscription",
"description": "Request deletion of an email subscription",
"operationId": "deleteEmailSubscription",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success"
}
}
}
},
"/email-subscriptions/{id}/catch-all": {
"post": {
"tags": [
"EmailSubscriptionService"
],
"summary": "Activate catch-all feature",
"description": "Activates the catch-all feature for a given email subscription (all emails sent to a non-existing email address will be redirected to the email address of the mailbox attached to the subscription)",
"operationId": "createCatchall",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmailSubscription"
}
}
}
}
}
},
"delete": {
"tags": [
"EmailSubscriptionService"
],
"summary": "Deactivate catch-all feature",
"description": "Deactivates the catch-all feature for a given email subscription (all emails sent to a non-existing email address will be lost)",
"operationId": "deleteCatchall",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmailSubscription"
}
}
}
}
}
}
},
"/email-subscriptions/{id}/password": {
"put": {
"tags": [
"EmailSubscriptionService"
],
"summary": "Update a mailbox password",
"description": "Change the password of the mailbox attached to the given email subscription",
"operationId": "updateEmailPassword",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmailPassword"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EmailSubscription"
}
}
}
}
}
}
},
"/https-redirect-subscriptions/create": {
"post": {
"tags": [
"HttpsRedirectService"
],
"summary": "Create a HTTPS redirect subscription",
"description": "Order the provisioning of a HTTPS redirect subscription.",
"operationId": "createHttpsRedirectSubscription",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateHttpsRedirectSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HttpsRedirectSubscription"
}
}
}
}
}
}
},
"/https-redirect-subscriptions/{subscription-id}": {
"get": {
"tags": [
"HttpsRedirectService"
],
"summary": "Get current details of a HTTPS redirect subscription",
"description": "Get HTTPS redirect subscription from its ID",
"operationId": "getHttpsRedirectSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HttpsRedirectSubscription"
}
}
}
}
}
},
"delete": {
"tags": [
"HttpsRedirectService"
],
"summary": "Delete a HTTPS redirect subscription",
"description": "Schedule the deletion of the HTTPS redirect subscription with given ID.",
"operationId": "deleteHttpsRedirectSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HttpsRedirectSubscription"
}
}
}
}
}
}
},
"/https-redirect-subscriptions/{subscription-id}/renew": {
"post": {
"tags": [
"HttpsRedirectService"
],
"summary": "Renew a HTTPS redirect subscription",
"description": "Order the renewal of a HTTPS redirect subscription.",
"operationId": "renewHttpsRedirectSubscription",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RenewHttpsRedirectSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HttpsRedirectSubscription"
}
}
}
}
}
}
},
"/premium-dns-subscriptions/reactivate": {
"post": {
"tags": [
"PremiumDnsSubscriptionService"
],
"summary": "Reactivate a Premium DNS subscription",
"description": "Order the reactivation of an Premium DNS subscription.",
"operationId": "reactivatePremiumDnsSubscription",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ReactivatePremiumDnsSubscription"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PremiumDnsSubscription"
}
}
}
}
}
}
},
"/subscriptions/{subscription-id}/autorenew-settings": {
"put": {
"tags": [
"SubscriptionService"
],
"summary": "Update subscription auto-renew settings",
"description": "Update the auto-renewal settings (activation and duration) of a subscription",
"operationId": "updateSubscriptionAutorenewSettings",
"parameters": [
{
"name": "subscription-id",
"in": "path",
"required": true,
"style": "simple",
"explode": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionAutoRenewSettings"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SubscriptionErrorResponse"
}
}
}
},
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Subscription"
}
}
}
}
}
}
},
"/contact-validations/resend-email": {
"post": {
"tags": [
"ContactValidationService"
],
"summary": "Resend contact validation email",
"description": "Send an email containing a link to validate the related contacts.",
"operationId": "resendContactValidationsEmails",
"requestBody": {
"description": "List of contacts to validate.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ResendContactValidationsEmails"
}
}
},
"required": true
},
"responses": {
"default": {
"description": "Request error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"200": {
"description": "Successful response returning a list of contact validation details for all sent emails.",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ContactValidation"
}
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"ContactType": {
"type": "string",
"enum": [
"PRIVATE_PERSON",
"COMPANY",
"ORGANISATION",
"PUBLIC_BODY"
]
},
"SslSubscription": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The unique id of the subscription",
"format": "int32"
},
"subscriptionType": {
"$ref": "#/components/schemas/SubscriptionType"
},
"deliveryDate": {
"type": "string",
"description": "The delivery date of the subscription",
"format": "date-time"
},
"expirationDate": {
"type": "string",
"description": "The date the subscription will expire",
"format": "date-time"
},
"updateDate": {
"type": "string",
"description": "The date of the last subscription update",
"format": "date-time"
},
"subscriptionStatus": {
"$ref": "#/components/schemas/SubscriptionStatus"
},
"active": {
"type": "boolean",
"description": "Tells if the service behind the subscription is effectively active or not."
},
"autoRenewSettings": {
"$ref": "#/components/schemas/SubscriptionAutoRenewSettings"
},
"domainName": {
"type": "string",
"description": "The domain name the subscription is attached to"
},
"productDescription": {
"type": "string",
"description": "The description of the product the subscription is attached to"
},
"renewable": {
"type": "boolean",
"description": "Defines if the subscription can be renewed."
},
"upgradable": {
"type": "boolean",
"description": "Defines if the subscription can be upgraded."
},
"downgradable": {
"type": "boolean",
"description": "Defines if the subscription can be downgraded."
},
"commonName": {
"type": "string",
"description": "The SSL subscription common name."
},
"multiDomain": {
"type": "boolean",
"description": "Defines if the SSL subscription is linked to multi-domain certificates."
},
"multiDomainSanQuantity": {
"type": "integer",
"description": "Defines the quantity of SANs linked to the SSL subscription. Only applicable for multi-domain subscriptions.",
"format": "int32"
},
"multiDomainSanWildcardQuantity": {
"type": "integer",
"description": "Defines the quantity of wildcard SANs linked to the SSL subscription. Only applicable for multi-domain subscriptions.",
"format": "int32"
},
"revoked": {
"type": "boolean",
"description": "Defines if the current SSL certificate of the subscription has been revoked."
},
"certificates": {
"type": "array",
"description": "The list of SSL certificates of the subscription. Cancelled, revoked and expired certificates are excluded.",
"items": {
"$ref": "#/components/schemas/SslCertificate"
}
}
}
},
"DnsZoneSnapshotPage": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "(read only) the zone snapshot identifier.",
"nullable": true
},
"zoneName": {
"type": "string",
"description": "(read only) the zone name",
"nullable": true
},
"createdAt": {
"type": "string",
"description": "(read only) the snapshot creation date",
"format": "date-time",
"nullable": true
},
"records": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/DnsRecord"
}
},
"urlForwards": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/UrlForward"
}
},
"mailForwards": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/MailForward"
}
}
}
},
"DnsZoneSnapshotItem": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "(read only) the zone snapshot identifier",
"nullable": true
},
"createdAt": {
"type": "string",
"description": "(read only) Creation date of the snapshot",
"format": "date-time",
"nullable": true
},
"zoneName": {
"type": "string",
"description": "(read only) the zone name",
"nullable": true
}
}
},
"SslApproverContact": {
"required": [
"email",
"firstName",
"jobTitle",
"lastName",
"organization",
"organizationUnit",
"phone"
],
"type": "object",
"properties": {
"organization": {
"type": "string",
"description": "The SSL certificate contact organization."
},
"firstName": {
"type": "string",
"description": "The SSL certificate contact firstname."
},
"lastName": {
"type": "string",
"description": "The SSL certificate contact lastname."
},
"jobTitle": {
"type": "string",
"description": "The SSL certificate contact job title."
},
"phone": {
"type": "string",
"description": "The SSL certificate contact phone number."
},
"email": {
"type": "string",
"description": "The SSL certificate contact email address."
},
"organizationUnit": {
"type": "string",
"description": "The SSL certificate contact organization unit."
}
},
"description": "The SSL certificate contact information used when provisioning an EXTENDED certificate. When not provided, the 'requestor' contact will also be used as 'approver'."
},
"SslSignerContact": {
"required": [
"email",
"firstName",
"jobTitle",
"lastName",
"organization",
"organizationUnit",
"phone"
],
"type": "object",
"properties": {
"organization": {
"type": "string",
"description": "The SSL certificate contact organization."
},
"firstName": {
"type": "string",
"description": "The SSL certificate contact firstname."
},
"lastName": {
"type": "string",
"description": "The SSL certificate contact lastname."
},
"jobTitle": {
"type": "string",
"description": "The SSL certificate contact job title."
},
"phone": {
"type": "string",
"description": "The SSL certificate contact phone number."
},
"email": {
"type": "string",
"description": "The SSL certificate contact email address."
},
"organizationUnit": {
"type": "string",
"description": "The SSL certificate contact organization unit."
}
},
"description": "The SSL certificate contact information used when provisioning an EXTENDED certificate. When not provided, the 'requestor' contact will also be used as 'signer'."
},
"ProxyStatus": {
"type": "string",
"description": "Proxy activation status for a record. (A, AAAA, CNAME and APEX records only)",
"enum": [
"ON",
"OFF",
"PENDING_ON"
]
},
"SignatureAlgorithm": {
"type": "string",
"enum": [
"ECC",
"RSA"
]
},
"PremiumSubscriptionProduct": {
"type": "string",
"description": "The Premium DNS product to order",
"example": "ANYCAST_DNS_PLUS",
"enum": [
"ANYCAST_DNS",
"ANYCAST_DNS_PLUS"
]
},
"DomainNameserver": {
"type": "object",
"properties": {
"fqdn": {
"type": "string",
"description": "The fully qualified domain name (FQDN), e.g., ns1.example.com"
}
}
},
"SslValidationApprover": {
"required": [
"verificationMethod"
],
"type": "object",
"properties": {
"verificationMethod": {
"$ref": "#/components/schemas/SslVerificationMethod"
},
"approver": {
"type": "string",
"description": "The new SSL certificate validation approver to use.
It must be part of the 'allowedApprovers' list you can get using the 'Get the validation information of an SSL certificate' operation."
}
},
"description": "The SSL certificate validation approver update data."
},
"RegionGroup": {
"type": "string",
"enum": [
"GTLD",
"NGTLD",
"CCTLD"
]
},
"DomainSearchRequest": {
"type": "object",
"properties": {
"term": {
"type": "string",
"description": "The search term used to filter out results in combination with the `termMatchingMode` and `termMatchFields` parameters",
"nullable": true
},
"termMatchingMode": {
"$ref": "#/components/schemas/TermMatchingMode"
},
"termMatchFields": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TermMatchField"
}
},
"tldName": {
"type": "string",
"description": "The exact TLD name of a domain",
"nullable": true
},
"active": {
"type": "boolean",
"description": "If `true`, only non expired domains will be included",
"nullable": true
},
"renewable": {
"type": "boolean",
"description": "If `true`, only renewable domains will be included",
"nullable": true
},
"reactivable": {
"type": "boolean",
"description": "If `true`, only reactivable domains will be included",
"nullable": true
},
"dnssecActivated": {
"type": "boolean",
"description": "If `true`, only domains with an active DNSSEC protection will be included",
"nullable": true
},
"pendingModification": {
"type": "boolean",
"description": "If `true`, only domains with an ongoing operation will be included",
"nullable": true
},
"useOurNameservers": {
"type": "boolean",
"description": "If `true`, only domains using our nameserver configuration will be included",
"nullable": true
},
"whoisPrivacy": {
"type": "boolean",
"description": "If `true`, only domains where domain privacy is activated will be included",
"nullable": true
},
"premiumDns": {
"type": "boolean",
"description": "If `true`, only domains using our premium DNS solution will be included",
"nullable": true
},
"premium": {
"type": "boolean",
"description": "If `true`, only premium domains will be included",
"nullable": true
},
"renewalMethod": {
"$ref": "#/components/schemas/RenewalMethod"
},
"folderFullPath": {
"type": "string",
"description": "Only domains with this exact folder path will be included",
"nullable": true
},
"contactValidated": {
"type": "boolean",
"description": "If `true`, only domains where the owner contact has been validated will be included",
"nullable": true
},
"contactValidationExpiringSoon": {
"type": "boolean",
"description": "Only domains with a contact validation close to expiring will be included",
"nullable": true
},
"contactValidationMethod": {
"$ref": "#/components/schemas/ContactValidationMethod"
}
}
},
"SubscriptionType": {
"type": "string",
"description": "The type of the subscription",
"enum": [
"MICROSOFT",
"EMAIL",
"PREMIUM_DNS",
"HOSTING",
"HTTPS_REDIRECT",
"SSL",
"WHOIS_PRIVACY"
]
},
"RenewHttpsRedirectSubscription": {
"type": "object",
"properties": {
"durationUnit": {
"$ref": "#/components/schemas/DurationUnitName"
},
"duration": {
"type": "number",
"description": "The renewal duration in the provided unit name."
}
},
"description": "The input data to order the renewal of a HTTPS redirect subscription."
},
"SubscriptionErrorResponse": {
"type": "object",
"properties": {
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"$ref": "#/components/schemas/SubscriptionErrorCode"
},
"title": {
"type": "string"
}
}
}
}
}
},
"BusinessCategory": {
"type": "string",
"description": "The business information category used when creating an ORGANIZATION or EXTENDED certificate.",
"enum": [
"PRIVATE_ORGANIZATION",
"GOVERNMENT_ENTITY",
"BUSINESS_ENTITY"
]
},
"DomainsAvailability": {
"type": "object",
"properties": {
"domainName": {
"type": "string"
},
"available": {
"type": "boolean"
}
}
},
"ResendContactValidationsEmails": {
"type": "object",
"properties": {
"contactsDetails": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ContactValidationDetails"
}
}
}
},
"UrlForwardError": {
"type": "object",
"properties": {
"messages": {
"type": "array",
"description": "list of error messages on record",
"items": {
"type": "string"
}
},
"urlForward": {
"$ref": "#/components/schemas/UrlForward"
},
"severity": {
"$ref": "#/components/schemas/Severity"
}
}
},
"RecordError": {
"type": "object",
"properties": {
"messages": {
"type": "array",
"description": "list of error messages on record",
"items": {
"type": "string"
}
},
"record": {
"$ref": "#/components/schemas/DnsRecord"
},
"severity": {
"$ref": "#/components/schemas/Severity"
}
}
},
"Subscription": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The unique id of the subscription",
"format": "int32"
},
"subscriptionType": {
"$ref": "#/components/schemas/SubscriptionType"
},
"deliveryDate": {
"type": "string",
"description": "The delivery date of the subscription",
"format": "date-time"
},
"expirationDate": {
"type": "string",
"description": "The date the subscription will expire",
"format": "date-time"
},
"updateDate": {
"type": "string",
"description": "The date of the last subscription update",
"format": "date-time"
},
"subscriptionStatus": {
"$ref": "#/components/schemas/SubscriptionStatus"
},
"active": {
"type": "boolean",
"description": "Tells if the service behind the subscription is effectively active or not."
},
"autoRenewSettings": {
"$ref": "#/components/schemas/SubscriptionAutoRenewSettings"
},
"domainName": {
"type": "string",
"description": "The domain name the subscription is attached to"
},
"productDescription": {
"type": "string",
"description": "The description of the product the subscription is attached to"
},
"renewable": {
"type": "boolean",
"description": "Defines if the subscription can be renewed."
},
"upgradable": {
"type": "boolean",
"description": "Defines if the subscription can be upgraded."
},
"downgradable": {
"type": "boolean",
"description": "Defines if the subscription can be downgraded."
}
}
},
"SslOrganizationInfo": {
"required": [
"name",
"organizationAddress"
],
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The SSL certificate organization name."
},
"organizationAddress": {
"$ref": "#/components/schemas/SslOrganizationAddress"
}
},
"description": "The SSL certificate organization information required when provisioning an ORGANIZATION or EXTENDED certificate."
},
"RenewSslSubscription": {
"type": "object",
"properties": {
"encodedCsr": {
"type": "string",
"description": "The SSL certificate encoded CSR containing the certificate data.
When not provided, the CSR used during the certificate provisioning will be reused.
Any Subject Alternative Name (SAN) present in the encoded CSR will be ignored during the provisioning.
To provision SANs for multi-domain products, provide them in the 'sanEntries' field.
The quantity of allowed host names depends on your original certificate order."
},
"verificationEmailAddress": {
"$ref": "#/components/schemas/SslVerificationEmailAddress"
},
"sanEntries": {
"type": "array",
"description": "The list of SAN names to add to the SSL multi-domain certificate. It is only required for multi-domain certificate products and must include the encoded CSR common name.",
"items": {
"type": "string"
}
}
},
"description": "The input data to renew an SSL subscription."
},
"SslBusinessInfo": {
"required": [
"businessCategory",
"city",
"countryCode"
],
"type": "object",
"properties": {
"countryCode": {
"type": "string",
"description": "The business country code (ISO 3166-1 alpha-2).",
"example": "US"
},
"city": {
"type": "string",
"description": "The business city.",
"example": "Boston"
},
"state": {
"type": "string",
"description": "The business state when relevant.",
"example": "Massachusetts"
},
"iarn": {
"type": "string",
"description": "The business IARN."
},
"businessCategory": {
"$ref": "#/components/schemas/BusinessCategory"
}
},
"description": "The SSL certificate business information required when provisioning an EXTENDED certificate."
},
"SubscriptionErrorCode": {
"type": "string",
"enum": [
"INVALID_REQUEST",
"SUBSCRIPTION_NOT_FOUND",
"SUBSCRIPTION_DELETED",
"CERTIFICATE_DELETED",
"SUBSCRIPTION_CREATION_FAILED",
"INVALID_ALIAS_FORMAT",
"ALIAS_ALREADY_EXISTS",
"CATCH_ALL_ALREADY_EXISTS",
"CATCH_ALL_NOT_FOUND",
"SUBSCRIPTION_NOT_RENEWABLE",
"INVALID_PRODUCT",
"FORBIDDEN_ACTION",
"SUBSCRIPTION_NOT_DELETABLE",
"INVALID_DURATION",
"INVALID_CSR",
"INVALID_COMMON_NAME",
"INVALID_SAN_CONFIGURATION",
"COMMON_NAME_SAN_NOT_FOUND",
"SAN_NOT_FOUND",
"VALIDATION_APPROVER_REQUIRED",
"FREE_SSL_ALREADY_EXISTS",
"SSL_CERTIFICATE_NOT_FOUND",
"CERTIFICATE_NOT_REVOCABLE",
"CERTIFICATE_NOT_REISSUABLE",
"CERTIFICATE_NOT_CANCELLABLE",
"SAN_COMMON_NAME_CANNOT_BE_DELETED",
"SSL_CERTIFICATE_EMPTY_SSL_CONTACT",
"AUTORENEW_VALUE_REQUIRED",
"SSL_VERIFICATION_EMAIL_ADDRESS_NOT_SUPPORTED",
"DOMAIN_WITH_DNSSEC",
"DOMAIN_PENDING",
"ORDER_CREATION_ERROR",
"PAYMENT_ERROR",
"SUBSCRIPTION_NOT_REACTIVABLE",
"SUBSCRIPTION_NOT_UPGRADABLE",
"SUBSCRIPTION_NOT_DOWNGRADABLE",
"SSL_VERIFICATION_EMAIL_ADDRESS_REQUIRED",
"SSL_VERIFICATION_METHOD_NOT_SUPPORTED",
"ZONE_ALREADY_EXISTS",
"PREMIUM_DNS_ALREADY_ACTIVE",
"SUBSCRIPTION_ALREADY_EXISTS",
"HTTPS_REDIRECT_INVALID_CAA"
]
},
"Nameserver": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int32"
},
"ipV4Address": {
"type": "string"
},
"ipV6Address": {
"type": "string"
},
"fqdn": {
"type": "string"
}
}
},
"ContactProfileDefaultStatus": {
"type": "object",
"properties": {
"org": {
"type": "boolean"
},
"admin": {
"type": "boolean"
},
"tech": {
"type": "boolean"
},
"billing": {
"type": "boolean"
}
}
},
"SslVerificationEmailAddress": {
"type": "string",
"description": "Required when using the 'EMAIL' verification method.
The username of the SSL certificate verification email address.
An email will be sent to the selected address on the CSR domain name or SAN host name if the 'EMAIL' verification method has been selected during the certificate configuration.
For example, if you select 'ADMIN' while validating an SSL certificate on 'subdomain.example.com', a validation email will be sent to 'admin@example.com'.
Once the certificate validation has begun, the validation method or selected email address can be updated via the 'Update the validation information of an SSL certificate' operation",
"example": "ADMIN",
"enum": [
"ADMIN",
"ADMINISTRATOR",
"HOSTMASTER",
"POSTMASTER",
"WEBMASTER"
]
},
"DnsZoneDnssecKey": {
"type": "object",
"properties": {
"dnssecTypeId": {
"type": "integer",
"nullable": true
},
"dnskeyDnssecFlagId": {
"type": "integer",
"nullable": true
},
"dnskeyDnssecProtocolId": {
"type": "integer",
"nullable": true
},
"dnskeyDnssecAlgorithm": {
"$ref": "#/components/schemas/DnsZoneDnssecAlgorithm"
},
"dnskeyPublicKey": {
"type": "string",
"nullable": true
},
"dsKeyTag": {
"type": "integer",
"nullable": true
},
"dsDnssecAlgorithmId": {
"type": "integer",
"nullable": true
},
"dsDnssecDigestTypeId": {
"type": "integer",
"nullable": true
},
"dsDigest": {
"type": "string",
"nullable": true
}
}
},
"UrlForwardType": {
"type": "string",
"description": "Forward mode: iframe, http 301 redirect or http 302 redirect",
"enum": [
"FRAME",
"HTTP301",
"HTTP302"
]
},
"ReactivatePremiumDnsSubscription": {
"type": "object",
"properties": {
"domainName": {
"type": "string"
},
"durationUnit": {
"$ref": "#/components/schemas/DurationUnitName"
},
"duration": {
"type": "number",
"description": "The reactivation duration in the provided unit name."
}
},
"description": "The input data to order the reactivation of a Premium DNS subscription."
},
"DomainSearchResult": {
"type": "object",
"properties": {
"domainName": {
"type": "string",
"description": "The domain name"
},
"tldName": {
"type": "string",
"description": "The domain TLD name"
},
"folderFullPath": {
"type": "string",
"description": "The complete domain folder structure"
},
"renewalMethod": {
"$ref": "#/components/schemas/RenewalMethod"
},
"creationDate": {
"type": "string",
"description": "The domain creation date",
"format": "date-time"
},
"lastUpdateDate": {
"type": "string",
"description": "The date of the last update of the domain",
"format": "date-time",
"nullable": true
},
"expirationDate": {
"type": "string",
"description": "The domain expiration date",
"format": "date-time"
},
"pendingModification": {
"type": "boolean",
"description": "`true` if a pending operation is ongoing on the domain",
"nullable": true
},
"active": {
"type": "boolean",
"description": "`true` if the domain is not expired"
},
"renewable": {
"type": "boolean",
"description": "`true` if the domain is currently renewable",
"nullable": true
},
"reactivable": {
"type": "boolean",
"description": "`true` if the domain is currently reactivable"
},
"dnssecActivated": {
"type": "boolean",
"description": "`true` if the domain has an active DNSSEC protection",
"nullable": true
},
"useOurNameservers": {
"type": "boolean",
"description": "`true` if the domain is using our nameserver configuration"
},
"whoisPrivacy": {
"type": "boolean",
"description": "`true` if domain privacy is activated on the domain"
},
"renewableFrom": {
"type": "string",
"description": "The date at which the domain will become renewable",
"format": "date-time"
},
"renewableUntil": {
"type": "string",
"description": "The date at which the domain will stop being renewable",
"format": "date-time"
},
"reactivateUntil": {
"type": "string",
"description": "The date at which the domain will stop being reactivable",
"format": "date-time"
},
"contactValidated": {
"type": "boolean",
"description": "`true` if the domain owner contact has been validated",
"nullable": true
},
"contactValidationExpirationDate": {
"type": "string",
"description": "The date until which the owner's contact validation remains valid",
"format": "date-time",
"nullable": true
},
"premiumDns": {
"type": "boolean",
"description": "`true` if the domain is using our premium DNS solution",
"nullable": true
},
"premium": {
"type": "boolean",
"description": "`true` if the domain is a premium domain name",
"nullable": true
},
"nameservers": {
"type": "array",
"description": "The list of nameservers the domain uses",
"items": {
"type": "string"
}
},
"contactValidationExpiringSoon": {
"type": "boolean",
"description": "`true` if the domain contact validation is close to expiring",
"nullable": true
},
"owner": {
"$ref": "#/components/schemas/DomainContact"
},
"admin": {
"$ref": "#/components/schemas/DomainContact"
},
"tech": {
"$ref": "#/components/schemas/DomainContact"
},
"billing": {
"$ref": "#/components/schemas/DomainContact"
}
}
},
"ContactValidation": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int32"
},
"userId": {
"type": "integer",
"format": "int32"
},
"email": {
"type": "string"
},
"requestDate": {
"$ref": "#/components/schemas/LocalDateTime"
},
"validationDate": {
"$ref": "#/components/schemas/LocalDateTime"
},
"expirationDate": {
"$ref": "#/components/schemas/LocalDateTime"
},
"lastReminderDate": {
"$ref": "#/components/schemas/LocalDateTime"
},
"validationStatus": {
"$ref": "#/components/schemas/ValidationStatus"
}
}
},
"SslType": {
"type": "string",
"description": "The SSL certificate type.",
"example": "DOMAIN_SSL",
"enum": [
"ALPHA_SSL",
"INSTANT_SSL",
"DOMAIN_SSL",
"ORGANIZATION_SSL",
"EXTENDED_SSL"
]
},
"MailForwardError": {
"type": "object",
"properties": {
"messages": {
"type": "array",
"description": "list of error messages on record",
"items": {
"type": "string"
}
},
"mailForward": {
"$ref": "#/components/schemas/MailForward"
},
"severity": {
"$ref": "#/components/schemas/Severity"
}
}
},
"Domain": {
"type": "object",
"properties": {
"domainName": {
"type": "string",
"description": "The domain name"
},
"tldName": {
"type": "string",
"description": "The domain TLD name"
},
"folderFullPath": {
"type": "string",
"description": "The complete domain folder path",
"nullable": true
},
"renewalMethod": {
"$ref": "#/components/schemas/RenewalMethod"
},
"creationDate": {
"type": "string",
"description": "The domain creation date",
"format": "date-time",
"nullable": true
},
"lastUpdateDate": {
"type": "string",
"description": "The date of the last update of the domain",
"format": "date-time",
"nullable": true
},
"expirationDate": {
"type": "string",
"description": "The domain expiration date",
"format": "date-time"
},
"active": {
"type": "boolean",
"description": "`true` if the domain is not expired"
},
"renewable": {
"type": "boolean",
"description": "`true` if the domain is currently renewable"
},
"reactivable": {
"type": "boolean",
"description": "`true` if the domain is currently reactivable"
},
"updatable": {
"type": "boolean",
"description": "`true` if the domain can be updated"
},
"renewableFrom": {
"type": "string",
"description": "The date at which the domain will become renewable",
"format": "date-time"
},
"renewableUntil": {
"type": "string",
"description": "The date at which the domain will stop being renewable",
"format": "date-time"
},
"reactivateUntil": {
"type": "string",
"description": "The date at which the domain will stop being reactivable",
"format": "date-time"
},
"contactValidated": {
"type": "boolean",
"description": "`true` if the domain owner contact has been validated",
"nullable": true
},
"contactValidationExpirationDate": {
"type": "string",
"description": "The date until which the owner's contact validation remains valid",
"format": "date-time",
"nullable": true
},
"owner": {
"$ref": "#/components/schemas/DomainContact"
},
"admin": {
"$ref": "#/components/schemas/DomainContact"
},
"tech": {
"$ref": "#/components/schemas/DomainContact"
},
"billing": {
"$ref": "#/components/schemas/DomainContact"
},
"nameservers": {
"type": "array",
"description": "The list of nameservers configured for the domain",
"items": {
"$ref": "#/components/schemas/DomainNameserver"
}
}
}
},
"DnsRecord": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "(read only) the DNS record identifier.",
"nullable": true
},
"type": {
"$ref": "#/components/schemas/DnsRecordType"
},
"host": {
"type": "string",
"description": "Name of the node to which this record pertains (i.e. NAME).",
"nullable": true
},
"ttl": {
"type": "integer",
"description": "Count of seconds that the Resource record stays valid.
Allowed values: `600`, `900`, `1800`,`3600`, `7200`, `14400`, `21600`, `43200`, `86400`, `172800`, `432000`, `604800`",
"nullable": true
},
"rdata": {
"type": "string",
"description": "RFC 1035 5.1 text representation of record data",
"nullable": true
},
"updated": {
"type": "boolean",
"description": "(read only) Indicates whether the Record has been modified by the user or the server during the Validate operation.",
"nullable": true
},
"locked": {
"type": "boolean",
"description": "(read only) record is locked and cannot be modified/removed.",
"nullable": true
},
"isDynDns": {
"type": "boolean",
"description": "(`A` Record only) enable DYNDNS for a A Record.",
"nullable": true
},
"proxy": {
"$ref": "#/components/schemas/ProxyStatus"
}
}
},
"DowngradePremiumDnsSubscription": {
"type": "object",
"properties": {
"subscriptionProduct": {
"$ref": "#/components/schemas/PremiumSubscriptionProduct"
}
},
"description": "The input data to order the downgrade of a Premium DNS subscription."
},
"NameserverProfile": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int32"
},
"name": {
"type": "string"
},
"defaultProfile": {
"type": "boolean"
},
"canDelete": {
"type": "boolean"
},
"nameservers": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Nameserver"
}
}
}
},
"LocalDateTime": {
"type": "string",
"format": "date-time"
},
"UrlForward": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "(read only) the URL forward record identifier.",
"nullable": true
},
"forwardType": {
"$ref": "#/components/schemas/UrlForwardType"
},
"host": {
"type": "string",
"description": "Name of the node to which this record pertains (i.e. NAME).",
"nullable": true
},
"url": {
"type": "string",
"description": "target URL to forward to.",
"nullable": true
},
"title": {
"type": "string",
"description": "(forwardType `FRAME` only) iframe title",
"nullable": true
},
"keywords": {
"type": "string",
"description": "(forwardType `FRAME` only) iframe keywords (space separated)",
"nullable": true
},
"description": {
"type": "string",
"description": "(forwardType `FRAME` only) iframe description",
"nullable": true
},
"updated": {
"type": "boolean",
"description": "(read only) Indicates whether the URL forward has been modified by the user or the server during the Validate operation.",
"nullable": true
}
}
},
"SslVerificationStatus": {
"type": "string",
"enum": [
"VERIFIED",
"PENDING",
"NOT_VERIFIED"
]
},
"ZoneProfilePage": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "(read only) the zone profile identifier.",
"nullable": true
},
"name": {
"type": "string",
"description": "the profile name",
"nullable": true
},
"domainConnect": {
"type": "boolean",
"description": "(read only) domain connect activation status",
"nullable": true
},
"records": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/DnsRecord"
}
},
"urlForwards": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/UrlForward"
}
},
"mailForwards": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/MailForward"
}
},
"report": {
"$ref": "#/components/schemas/ZoneValidationReport"
}
}
},
"CreateSslSubscription": {
"required": [
"contact",
"encodedCsr",
"subscriptionProduct",
"verificationMethod"
],
"type": "object",
"properties": {
"subscriptionProduct": {
"$ref": "#/components/schemas/SslSubscriptionProduct"
},
"encodedCsr": {
"type": "string",
"description": "The SSL certificate encoded CSR containing the certificate data.
Any Subject Alternative Name (SAN) present in the encoded CSR will be ignored during the provisioning.
To provision SANs for multi-domain products, provide them in the 'sanEntries' field.
The CSR must include a subject, a common name, and a valid email address.
Using the RSA signature algorithm, a key length between 2048 and 8192 must be used.
Using the ECC signature algorithm, a key length between 256 and 384 must be used. "
},
"contact": {
"$ref": "#/components/schemas/SslContact"
},
"outlookWebAccess": {
"type": "boolean",
"description": "Unified Communication Cert Option, allows 'owa' subdomain to be added for free.
Available for 'domain', 'extended' and 'organization' certificates.",
"default": false
},
"mail": {
"type": "boolean",
"description": "Unified Communication Cert Option, allows 'mail' subdomain to be added for free.
Available for 'domain', 'extended' and 'organization' certificates.",
"default": false
},
"autoDiscover": {
"type": "boolean",
"description": "Unified Communication Cert Option, allows 'autodiscover' subdomain to be added for free.
Available for 'domain', 'extended' and 'organization' certificates.",
"default": false
},
"verificationMethod": {
"$ref": "#/components/schemas/SslVerificationMethod"
},
"verificationEmailAddress": {
"$ref": "#/components/schemas/SslVerificationEmailAddress"
},
"organizationInfo": {
"$ref": "#/components/schemas/SslOrganizationInfo"
},
"businessInfo": {
"$ref": "#/components/schemas/SslBusinessInfo"
},
"requestor": {
"$ref": "#/components/schemas/SslRequestorContact"
},
"approver": {
"$ref": "#/components/schemas/SslApproverContact"
},
"signer": {
"$ref": "#/components/schemas/SslSignerContact"
},
"sanEntries": {
"type": "array",
"description": "The list of Subject Alternative Name (SAN) to provision on the SSL multi-domain certificate.
It is only required for multi-domain certificate products and must include the encoded CSR common name.
It cannot exceed 250 host names.",
"items": {
"type": "string"
}
},
"skipUseAvailableToken": {
"type": "boolean",
"description": "When set to true, the API will always purchase a new token instead of activating an existing one. Default value: false",
"default": false
}
},
"description": "The input data to order an SSL subscription."
},
"RenewPremiumDnsSubscription": {
"type": "object",
"properties": {
"durationUnit": {
"$ref": "#/components/schemas/DurationUnitName"
},
"duration": {
"type": "number",
"description": "The renewal duration in the provided unit name."
}
},
"description": "The input data to order the renewal of a Premium DNS subscription."
},
"SubscriptionAutoRenewSettings": {
"required": [
"autoRenewEnabled"
],
"type": "object",
"properties": {
"autoRenewEnabled": {
"type": "boolean",
"description": "Tells if auto-renewal is enabled or not for this subscription."
},
"autoRenewDurationInMonths": {
"type": "integer",
"description": "The time in months the subscription will last before it gets automatically renewed",
"format": "int32"
}
},
"description": "Auto-renewal configuration of the subscription"
},
"EmailPassword": {
"type": "object",
"properties": {
"password": {
"type": "string"
},
"passwordConfirmation": {
"type": "string"
}
}
},
"SslOrganizationAddress": {
"required": [
"address1",
"city",
"countryCode",
"phone",
"zipCode"
],
"type": "object",
"properties": {
"address1": {
"type": "string",
"description": "The SSL certificate organization first address line."
},
"address2": {
"type": "string",
"description": "The SSL certificate organization second line."
},
"address3": {
"type": "string",
"description": "The SSL certificate organization third line."
},
"city": {
"type": "string",
"description": "The SSL certificate organization city.",
"example": "Boston"
},
"state": {
"type": "string",
"description": "The SSL certificate organization state.",
"example": "Massachusetts"
},
"zipCode": {
"type": "string",
"description": "The SSL certificate organization zip code."
},
"countryCode": {
"type": "string",
"description": "The SSL certificate organization country code (ISO 3166-1 alpha-2).",
"example": "US"
},
"phone": {
"type": "string",
"description": "The SSL certificate organization phone number."
},
"fax": {
"type": "string",
"description": "The SSL certificate organization fax number."
}
},
"description": "The SSL certificate organization address. It is only required for 'organization' and 'extended' SSL certificates."
},
"Tld": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"regionGroup": {
"$ref": "#/components/schemas/RegionGroup"
},
"country": {
"type": "string"
},
"minSubscriptionPeriod": {
"type": "integer"
},
"incSubscriptionPeriod": {
"type": "integer"
},
"maxSubscriptionPeriod": {
"type": "integer"
},
"registrationDelay": {
"type": "string",
"nullable": true
},
"minRenewPeriod": {
"type": "integer"
},
"incRenewPeriod": {
"type": "integer"
},
"maxRenewPeriod": {
"type": "integer"
},
"dayRenewBeforeExpiration": {
"type": "integer"
},
"minCharAllowed": {
"type": "integer"
},
"maxCharAllowed": {
"type": "integer"
},
"hyphenAllowed": {
"type": "boolean"
},
"numberAllowed": {
"type": "boolean"
},
"localOwnerRequired": {
"type": "boolean"
},
"localAdminRequired": {
"type": "boolean"
},
"localTechRequired": {
"type": "boolean"
},
"localBillingRequired": {
"type": "boolean"
},
"minNSAllowed": {
"type": "integer"
},
"maxNSAllowed": {
"type": "integer"
},
"needContactValidation": {
"type": "boolean"
},
"lockingEnabled": {
"type": "boolean"
},
"whoisPrivacy": {
"type": "boolean"
}
}
},
"ContactValidationMethod": {
"type": "string",
"enum": [
"EMAIL",
"NIS2"
]
},
"TermMatchingMode": {
"type": "string",
"default": "CONTAINS",
"enum": [
"CONTAINS",
"STARTS_WITH",
"EXACTLY"
]
},
"SslStatus": {
"type": "string",
"description": "The SSL certificate status.",
"enum": [
"ACTIVE",
"WAITING_FOR_VALIDATION",
"ERROR",
"INITIAL",
"DRAFT",
"REVOKED",
"EXPIRED",
"APPLICATION",
"TO_CANCEL",
"CANCELLED",
"WAITING_FOR_REVOCATION",
"VALIDATED",
"PHISHING_CHECK",
"TRANSFERRED"
]
},
"DomainContact": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"description": "The contact first name",
"nullable": true
},
"lastName": {
"type": "string",
"description": "The contact last name",
"nullable": true
},
"company": {
"type": "string",
"description": "The contact company name",
"nullable": true
},
"address1": {
"type": "string",
"description": "The contact first address line",
"nullable": true
},
"address2": {
"type": "string",
"description": "The contact second address line",
"nullable": true
},
"address3": {
"type": "string",
"description": "The contact third address line",
"nullable": true
},
"city": {
"type": "string",
"description": "The contact city name",
"nullable": true
},
"zipCode": {
"type": "string",
"description": "The contact zip code",
"nullable": true
},
"countryCode": {
"type": "string",
"description": "The contact country code",
"nullable": true
},
"email": {
"type": "string",
"description": "The contact email address",
"nullable": true
},
"phone": {
"type": "string",
"description": "The contact phone number",
"nullable": true
},
"fax": {
"type": "string",
"description": "The contact fax number",
"nullable": true
}
},
"description": "The domain contact information"
},
"DnsZoneDnssecAlgorithm": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
}
},
"SslVerificationMethod": {
"type": "string",
"description": "The SSL certificate domain ownership validation method.
- When selecting EMAIL, an email will be sent by the SSL certificate provider to the address provided during the certificate registration.
- When selecting URL, a security token will need to be uploaded to your website and a crawler will verify its presence.
- When selecting DNS, a DNS record will need to be added to the domain's zone records and a crawler will verify its presence. Sectigo only validates CNAME records while GlobalSign only validates TXT records.",
"enum": [
"EMAIL",
"URL",
"DNS"
]
},
"CreatePremiumDnsSubscription": {
"type": "object",
"properties": {
"subscriptionProduct": {
"$ref": "#/components/schemas/PremiumSubscriptionProduct"
},
"domainName": {
"type": "string",
"description": "The domain name on which the Premium DNS subscription will be provisioned."
},
"zoneProfileId": {
"type": "integer",
"description": "The id of the zone profile to apply, if any. The zone profile will not be applied if the domain is currently on our nameservers",
"format": "int32"
},
"durationUnit": {
"$ref": "#/components/schemas/DurationUnitName"
},
"duration": {
"type": "number",
"description": "The Premium DNS subscription duration in the provided unit name."
}
},
"description": "The input data to order an Premium DNS subscription."
},
"PremiumDnsSubscription": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The unique id of the subscription",
"format": "int32"
},
"subscriptionType": {
"$ref": "#/components/schemas/SubscriptionType"
},
"deliveryDate": {
"type": "string",
"description": "The delivery date of the subscription",
"format": "date-time"
},
"expirationDate": {
"type": "string",
"description": "The date the subscription will expire",
"format": "date-time"
},
"updateDate": {
"type": "string",
"description": "The date of the last subscription update",
"format": "date-time"
},
"subscriptionStatus": {
"$ref": "#/components/schemas/SubscriptionStatus"
},
"active": {
"type": "boolean",
"description": "Tells if the service behind the subscription is effectively active or not."
},
"autoRenewSettings": {
"$ref": "#/components/schemas/SubscriptionAutoRenewSettings"
},
"domainName": {
"type": "string",
"description": "The domain name the subscription is attached to"
},
"productDescription": {
"type": "string",
"description": "The description of the product the subscription is attached to"
},
"renewable": {
"type": "boolean",
"description": "Defines if the subscription can be renewed."
},
"upgradable": {
"type": "boolean",
"description": "Defines if the subscription can be upgraded."
},
"downgradable": {
"type": "boolean",
"description": "Defines if the subscription can be downgraded."
}
}
},
"EmailSubscription": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The unique id of the subscription",
"format": "int32"
},
"subscriptionType": {
"$ref": "#/components/schemas/SubscriptionType"
},
"deliveryDate": {
"type": "string",
"description": "The delivery date of the subscription",
"format": "date-time"
},
"expirationDate": {
"type": "string",
"description": "The date the subscription will expire",
"format": "date-time"
},
"updateDate": {
"type": "string",
"description": "The date of the last subscription update",
"format": "date-time"
},
"subscriptionStatus": {
"$ref": "#/components/schemas/SubscriptionStatus"
},
"active": {
"type": "boolean",
"description": "Tells if the service behind the subscription is effectively active or not."
},
"autoRenewSettings": {
"$ref": "#/components/schemas/SubscriptionAutoRenewSettings"
},
"domainName": {
"type": "string",
"description": "The domain name the subscription is attached to"
},
"productDescription": {
"type": "string",
"description": "The description of the product the subscription is attached to"
},
"renewable": {
"type": "boolean",
"description": "Defines if the subscription can be renewed."
},
"upgradable": {
"type": "boolean",
"description": "Defines if the subscription can be upgraded."
},
"downgradable": {
"type": "boolean",
"description": "Defines if the subscription can be downgraded."
},
"emailAddress": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"catchAll": {
"type": "boolean"
},
"maxMailQuotaInMb": {
"type": "integer",
"format": "int64"
},
"usedMailQuotaInMb": {
"type": "integer",
"format": "int64"
}
}
},
"SslSubscriptionProduct": {
"type": "string",
"description": "The SSL certificate product to order",
"example": "SECTIGO_DV",
"enum": [
"SECTIGO_INSTANT_DV",
"SECTIGO_INSTANT_DV_WILDCARD",
"SECTIGO_DV",
"SECTIGO_DV_WILDCARD",
"SECTIGO_DV_MULTI_DOMAIN",
"SECTIGO_OV",
"SECTIGO_OV_WILDCARD",
"SECTIGO_OV_MULTI_DOMAIN",
"SECTIGO_EV",
"SECTIGO_EV_MULTI_DOMAIN",
"GLOBALSIGN_ALPHA",
"GLOBALSIGN_ALPHA_WILDCARD",
"GLOBALSIGN_DV",
"GLOBALSIGN_DV_WILDCARD",
"GLOBALSIGN_OV",
"GLOBALSIGN_OV_WILDCARD",
"GLOBALSIGN_EV"
]
},
"HttpsRedirectSslStatus": {
"type": "string",
"enum": [
"ACTIVE",
"PENDING",
"NO_FORWARD"
]
},
"SslCsr": {
"type": "object",
"properties": {
"encodedCsr": {
"type": "string",
"description": "The encoded CSR data."
},
"commonName": {
"type": "string",
"description": "The CSR common name."
},
"domainName": {
"type": "string",
"description": "The CSR domain name."
},
"email": {
"type": "string",
"description": "The CSR email address."
},
"locality": {
"type": "string",
"description": "The CSR locality."
},
"organization": {
"type": "string",
"description": "The CSR organization."
},
"organizationUnit": {
"type": "string",
"description": "The CSR organization unit."
},
"state": {
"type": "string",
"description": "The CSR state."
},
"countryCode": {
"type": "string",
"description": "The CSR country code (ISO 3166-1 alpha-2)."
},
"keyLength": {
"type": "integer",
"description": "The CSR key length.",
"format": "int32"
},
"signatureAlgorithm": {
"$ref": "#/components/schemas/SignatureAlgorithm"
}
},
"description": "The SSL certificate CSR."
},
"ContactProfile": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int32"
},
"contactType": {
"$ref": "#/components/schemas/ContactType"
},
"profileName": {
"type": "string"
},
"companyName": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"address1": {
"type": "string"
},
"address2": {
"type": "string"
},
"address3": {
"type": "string"
},
"zipCode": {
"type": "string"
},
"city": {
"type": "string"
},
"countryCode": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"fax": {
"type": "string"
},
"isOrg": {
"type": "boolean"
},
"isAdmin": {
"type": "boolean"
},
"isTech": {
"type": "boolean"
},
"isBilling": {
"type": "boolean"
}
}
},
"DurationUnitName": {
"type": "string",
"description": "The time unit the product will last for",
"example": "MONTH",
"enum": [
"YEAR",
"MONTH"
]
},
"RenewalMethod": {
"type": "string",
"description": "The domain configured renewal method.
- `AUTORENEW`: a renewal order will be placed automatically once the domain expiration date is approaching
- `AUTOEXPIRE`: no order will be placed and the domain will expire",
"enum": [
"AUTORENEW",
"AUTOEXPIRE"
]
},
"MailForward": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "(read only) the Mail forward record identifier.",
"nullable": true
},
"source": {
"type": "string",
"description": "Left part of the Email address to forward from. Use `*` to create a Catch-All rule",
"nullable": true
},
"destination": {
"type": "string",
"description": "Email address to forward to.",
"nullable": true
},
"updated": {
"type": "boolean",
"description": "(read only) Indicates whether the Mail forward has been modified by the user or the server during the Validate operation.",
"nullable": true
}
}
},
"DnsZoneDnssecStatus": {
"type": "object",
"properties": {
"zoneName": {
"type": "string",
"nullable": true
},
"status": {
"$ref": "#/components/schemas/DnssecStatus"
},
"dnssecKeyDtoArray": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/DnsZoneDnssecKey"
}
}
}
},
"ZoneError": {
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Message describing the error of conflict between records."
},
"records": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DnsRecord"
}
},
"urlForwards": {
"type": "array",
"items": {
"$ref": "#/components/schemas/UrlForward"
}
},
"mailForwards": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MailForward"
}
},
"severity": {
"$ref": "#/components/schemas/Severity"
}
}
},
"MicrosoftSubscription": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The unique id of the subscription",
"format": "int32"
},
"subscriptionType": {
"$ref": "#/components/schemas/SubscriptionType"
},
"deliveryDate": {
"type": "string",
"description": "The delivery date of the subscription",
"format": "date-time"
},
"expirationDate": {
"type": "string",
"description": "The date the subscription will expire",
"format": "date-time"
},
"updateDate": {
"type": "string",
"description": "The date of the last subscription update",
"format": "date-time"
},
"subscriptionStatus": {
"$ref": "#/components/schemas/SubscriptionStatus"
},
"active": {
"type": "boolean",
"description": "Tells if the service behind the subscription is effectively active or not."
},
"autoRenewSettings": {
"$ref": "#/components/schemas/SubscriptionAutoRenewSettings"
},
"domainName": {
"type": "string",
"description": "The domain name the subscription is attached to"
},
"productDescription": {
"type": "string",
"description": "The description of the product the subscription is attached to"
},
"renewable": {
"type": "boolean",
"description": "Defines if the subscription can be renewed."
},
"upgradable": {
"type": "boolean",
"description": "Defines if the subscription can be upgraded."
},
"downgradable": {
"type": "boolean",
"description": "Defines if the subscription can be downgraded."
},
"accountLabel": {
"type": "string",
"description": "The account label of your subscription, also used as Microsoft tenant name"
},
"licencesCount": {
"type": "integer",
"description": "The number of ordered licences",
"format": "int32"
},
"microsoftDomain": {
"type": "string",
"description": "The microsoft domain related to your subscription, for instance example.onmicrosoft.com"
}
}
},
"SslRequestorContact": {
"required": [
"email",
"firstName",
"jobTitle",
"lastName",
"organization",
"organizationUnit",
"phone"
],
"type": "object",
"properties": {
"organization": {
"type": "string",
"description": "The SSL certificate contact organization."
},
"firstName": {
"type": "string",
"description": "The SSL certificate contact firstname."
},
"lastName": {
"type": "string",
"description": "The SSL certificate contact lastname."
},
"jobTitle": {
"type": "string",
"description": "The SSL certificate contact job title."
},
"phone": {
"type": "string",
"description": "The SSL certificate contact phone number."
},
"email": {
"type": "string",
"description": "The SSL certificate contact email address."
},
"organizationUnit": {
"type": "string",
"description": "The SSL certificate contact organization unit."
}
},
"description": "The SSL certificate contact information required when provisioning an EXTENDED certificate."
},
"UpgradePremiumDnsSubscription": {
"type": "object",
"properties": {
"subscriptionProduct": {
"$ref": "#/components/schemas/PremiumSubscriptionProduct"
}
},
"description": "The input data to order the upgrade of a Premium DNS subscription."
},
"SslContact": {
"required": [
"email",
"firstName",
"jobTitle",
"lastName",
"organization",
"organizationUnit",
"phone"
],
"type": "object",
"properties": {
"organization": {
"type": "string",
"description": "The SSL certificate contact organization."
},
"firstName": {
"type": "string",
"description": "The SSL certificate contact firstname."
},
"lastName": {
"type": "string",
"description": "The SSL certificate contact lastname."
},
"jobTitle": {
"type": "string",
"description": "The SSL certificate contact job title."
},
"phone": {
"type": "string",
"description": "The SSL certificate contact phone number."
},
"email": {
"type": "string",
"description": "The SSL certificate contact email address."
},
"organizationUnit": {
"type": "string",
"description": "The SSL certificate contact organization unit."
}
},
"description": "The SSL certificate contact information."
},
"Error": {
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "the HTTP status code applicable to this problem",
"nullable": true
},
"code": {
"type": "string",
"description": "an application-specific error code"
},
"title": {
"type": "string",
"description": "a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence"
},
"meta": {
"type": "object",
"description": "a meta-object containing non-standard meta-information about the error."
}
},
"description": "Class ErrorDto"
},
"CreateHttpsRedirectSubscription": {
"type": "object",
"properties": {
"subscriptionProduct": {
"$ref": "#/components/schemas/HttpsRedirectSubscriptionProduct"
},
"domainName": {
"type": "string",
"description": "The domain name on which the HTTPS redirect subscription will be provisioned."
},
"durationUnit": {
"$ref": "#/components/schemas/DurationUnitName"
},
"duration": {
"type": "number",
"description": "The HTTPS redirect subscription duration in the provided unit name."
}
},
"description": "The input data to order a HTTPS redirect subscription."
},
"SortOrder": {
"type": "string",
"enum": [
"ASC",
"DESC"
]
},
"DnsRecordType": {
"type": "string",
"description": "Type of Record (per defined in RFCs 1035, 3596, 2782, 4408, 6844).
`APEX`: APEX Alias record\na.k.a. ANAME for Address-specific DNS Name Redirection.
`MAIL`, `URL`: pseudo Record types for Mail and URL forward\nRecords.",
"enum": [
"A",
"AAAA",
"CNAME",
"MX",
"NS",
"PTR",
"SOA",
"SRV",
"TXT",
"SPF",
"CAA",
"APEX",
"TLSA",
"MAIL",
"URL",
"SVCB",
"HTTPS",
"DS"
]
},
"Severity": {
"type": "string",
"enum": [
"ERROR",
"WARNING"
]
},
"ZoneValidationReport": {
"type": "object",
"properties": {
"isValid": {
"type": "boolean",
"description": "Indicates whether changes posted to the Validate operation are valid.",
"nullable": true
},
"recordErrors": {
"type": "array",
"description": "Validation errors on DNS Records (independently from other records in the zone).",
"nullable": true,
"items": {
"$ref": "#/components/schemas/RecordError"
}
},
"urlForwardErrors": {
"type": "array",
"description": "Validation errors on URL forward Records (independently from other records in the zone).",
"nullable": true,
"items": {
"$ref": "#/components/schemas/UrlForwardError"
}
},
"mailForwardErrors": {
"type": "array",
"description": "Validation errors on Mail forward Records (independently from other records in the zone).",
"nullable": true,
"items": {
"$ref": "#/components/schemas/MailForwardError"
}
},
"zoneErrors": {
"type": "array",
"description": "Errors at DNS Zone level, triggered when there are records conflicting between each others.",
"nullable": true,
"items": {
"$ref": "#/components/schemas/ZoneError"
}
}
},
"description": "the validation report, only present on responses from the Validate operation"
},
"TermMatchField": {
"type": "string",
"default": "DOMAIN_NAME",
"enum": [
"DOMAIN_NAME",
"FOLDER",
"CONTACTS",
"OWNER_CONTACT",
"ADMIN_CONTACT",
"TECHNICAL_CONTACT",
"BILLING_CONTACT",
"NAMESERVERS"
]
},
"UpgradeSslSubscriptionQuantity": {
"type": "object",
"properties": {
"additionalSanQuantity": {
"type": "integer",
"description": "The quantity of SAN to add to the existing subscription.",
"format": "int32",
"default": 0
},
"additionalSanWildcardQuantity": {
"type": "integer",
"description": "The quantity of wildcard SAN to add to the existing subscription.",
"format": "int32",
"default": 0
}
},
"description": "The input data to upgrade the number of allowed Subject Alternative Name (SAN) of an SSL subscription.
At least one of the san quantity field must be provided and be positive.
The subscription total SAN quantity cannot exceed 250.
Only allowed for multi-domain products."
},
"ErrorResponse": {
"type": "object",
"properties": {
"errors": {
"type": "array",
"description": "an array of error objects",
"items": {
"$ref": "#/components/schemas/Error"
}
}
},
"description": "Class ErrorResponseDto"
},
"ValidationStatus": {
"type": "string",
"enum": [
"UNNECESSARY",
"UNVALIDATED",
"PENDING",
"VALIDATED",
"VALIDATION_EXPIRE_SOON",
"VALIDATION_IS_EXPIRED",
"ERROR"
]
},
"ContactValidationDetails": {
"type": "object",
"properties": {
"email": {
"type": "string"
},
"phone": {
"type": "string"
}
}
},
"SslCertificate": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The SSL certificate identifier.",
"format": "int32"
},
"sslType": {
"$ref": "#/components/schemas/SslType"
},
"csr": {
"$ref": "#/components/schemas/SslCsr"
},
"pkcs7Certificate": {
"type": "string",
"description": "The SSL certificate PKCS #7 value."
},
"x509CaCertificates": {
"type": "array",
"description": "The intermediate and root certificates' X.509 values.
Sorted from the first intermediate certificate to the root certificate",
"items": {
"type": "string"
}
},
"x509Certificate": {
"type": "string",
"description": "The end-user SSL certificate X.509 value."
},
"sslContacts": {
"type": "array",
"description": "The SSL certificate contacts.",
"items": {
"$ref": "#/components/schemas/SslContact"
}
},
"outlookWebAccess": {
"type": "boolean",
"description": "Unified Communication Cert Option, allows 'owa' subdomain to be added for free.
Available for 'domain', 'extended' and 'organization' certificates."
},
"mail": {
"type": "boolean",
"description": "Unified Communication Cert Option, allows 'mail' subdomain to be added for free.
Available for 'domain', 'extended' and 'organization' certificates."
},
"autodiscover": {
"type": "boolean",
"description": "Unified Communication Cert Option, allows 'autodiscover' subdomain to be added for free.
Available for 'domain', 'extended' and 'organization' certificates."
},
"startDate": {
"type": "string",
"description": "The SSL certificate start date.",
"format": "date-time"
},
"endDate": {
"type": "string",
"description": "The SSL certificate end date.",
"format": "date-time"
},
"organizationInfo": {
"$ref": "#/components/schemas/SslOrganizationInfo"
},
"extendedRequestor": {
"$ref": "#/components/schemas/SslContact"
},
"extendedApprover": {
"$ref": "#/components/schemas/SslContact"
},
"extendedSigner": {
"$ref": "#/components/schemas/SslContact"
},
"sslBusinessInfo": {
"$ref": "#/components/schemas/SslBusinessInfo"
},
"sans": {
"type": "array",
"description": "The SSL certificate SANs.",
"items": {
"$ref": "#/components/schemas/SslSan"
}
},
"status": {
"$ref": "#/components/schemas/SslStatus"
},
"action": {
"$ref": "#/components/schemas/OrderSslAction"
},
"description": {
"type": "string",
"description": "The SSL certificate description."
},
"validationRequired": {
"type": "boolean",
"description": "Defines if the SSL certificate validation is required."
},
"cancellable": {
"type": "boolean",
"description": "Defines if the SSL certificate validation process can be cancelled.
ISSUE and RENEW actions can be cancelled for 7 days during the validation process (status WAITING_FOR_VALIDATION).
Once the SSL certificate has been delivered, cancellation is no longer possible."
},
"revocable": {
"type": "boolean",
"description": "Defines if the SSL certificate can be revoked."
},
"reissuable": {
"type": "boolean",
"description": "Defines if the SSL certificate can be reissued.
A certificate can be reissued if all the following conditions are matched:
- the certificate is not expired
- the certificate does not have a pending operation
- the subscription does not already have a pending reissue
- the Sectigo certificate has not be revoked (does not apply to GlobalSign)"
},
"authorityRootCertificateLink": {
"type": "string",
"description": "A link to the SSL certificate root certificate. The root certificates can also be found in the 'x509CaCertificates' field."
},
"pending": {
"type": "boolean",
"description": "Defines if the SSL certificate has a pending action.
It includes validation, cancellation and revocation actions."
},
"canReissueAfterRevocation": {
"type": "boolean",
"description": "Defines if the SSL certificate can be reissued after it is revoked."
}
}
},
"SubscriptionStatus": {
"type": "string",
"description": "The current status of the subscription",
"enum": [
"ACTIVE",
"TO_RESTORE",
"TO_RENEW",
"TO_DELETE",
"PENDING_RENEW",
"PENDING_RENEW_DOWNGRABLE",
"UPGRADE_QUANTITY",
"PENDING_UPGRADE_PRODUCT",
"HOLD",
"PENDING_DOWNGRADE_PRODUCT",
"MIGRATED",
"PENDING_REACTIVATE",
"PROVISIONING"
]
},
"GetDomainsAvailability": {
"type": "object",
"properties": {
"domainNames": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"DnsZonePage": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "(read only) the DNS zone name",
"nullable": true
},
"domainConnect": {
"type": "boolean",
"description": "domain connect activation status",
"nullable": true
},
"records": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/DnsRecord"
}
},
"urlForwards": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/UrlForward"
}
},
"mailForwards": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/MailForward"
}
},
"report": {
"$ref": "#/components/schemas/ZoneValidationReport"
}
}
},
"DnssecStatus": {
"type": "string",
"description": "DNSSEC Status of the zone",
"enum": [
"SIGNED",
"SIGN_PENDING",
"SIGN_ERROR",
"UNSIGNED",
"UNSIGN_PENDING",
"UNSIGN_ERROR"
]
},
"ZoneProfile": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "(read only) the zone snapshot identifier.",
"nullable": true
},
"name": {
"type": "string",
"description": "(read only) the zone name",
"nullable": true
}
}
},
"SslValidation": {
"type": "object",
"properties": {
"sslVerificationMethod": {
"$ref": "#/components/schemas/SslVerificationMethod"
},
"allowedApprovers": {
"type": "array",
"description": "The list of allowed approvers selectable during the certificate SAN validation.",
"items": {
"type": "string"
}
},
"approver": {
"type": "string",
"description": "The selected verification approver used during the certificate SAN validation."
},
"securityToken": {
"type": "string",
"description": "The validation security token."
},
"fileValidationUrls": {
"type": "array",
"description": "The list of allowed URLs to use during a certificate SAN validation of 'URL' type.",
"items": {
"type": "string"
}
},
"sslVerificationStatus": {
"$ref": "#/components/schemas/SslVerificationStatus"
}
},
"description": "The SSL certificate data used to prove domain ownership of a certificate."
},
"HttpsRedirectSubscription": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The unique id of the subscription",
"format": "int32"
},
"subscriptionType": {
"$ref": "#/components/schemas/SubscriptionType"
},
"deliveryDate": {
"type": "string",
"description": "The delivery date of the subscription",
"format": "date-time"
},
"expirationDate": {
"type": "string",
"description": "The date the subscription will expire",
"format": "date-time"
},
"updateDate": {
"type": "string",
"description": "The date of the last subscription update",
"format": "date-time"
},
"subscriptionStatus": {
"$ref": "#/components/schemas/SubscriptionStatus"
},
"active": {
"type": "boolean",
"description": "Tells if the service behind the subscription is effectively active or not."
},
"autoRenewSettings": {
"$ref": "#/components/schemas/SubscriptionAutoRenewSettings"
},
"domainName": {
"type": "string",
"description": "The domain name the subscription is attached to"
},
"productDescription": {
"type": "string",
"description": "The description of the product the subscription is attached to"
},
"renewable": {
"type": "boolean",
"description": "Defines if the subscription can be renewed."
},
"upgradable": {
"type": "boolean",
"description": "Defines if the subscription can be upgraded."
},
"downgradable": {
"type": "boolean",
"description": "Defines if the subscription can be downgraded."
},
"sslStatus": {
"$ref": "#/components/schemas/HttpsRedirectSslStatus"
}
}
},
"HttpsRedirectSubscriptionProduct": {
"type": "string",
"description": "The HTTPS redirect product to order",
"example": "HTTPS_REDIRECT",
"enum": [
"HTTPS_REDIRECT"
]
},
"SslSan": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The SAN name."
},
"sslVerificationMethod": {
"$ref": "#/components/schemas/SslVerificationMethod"
},
"sslVerificationStatus": {
"$ref": "#/components/schemas/SslVerificationStatus"
},
"securityToken": {
"type": "string",
"description": "The validation security token to set during a DNS or URL validation."
},
"securityTokenList": {
"type": "string",
"description": "The list of allowed domains selectable during the certificate SAN validation."
},
"verificationApprover": {
"type": "string",
"description": "The selected verification approver used during the certificate SAN validation."
},
"isWildCard": {
"type": "boolean",
"description": "Explicit whereas the SAN is a wildcard or not."
},
"isCommonName": {
"type": "boolean",
"description": "Explicit whereas the SAN is the common name of the SSL certificate or not."
}
},
"description": "The SSL certificate SAN information."
},
"ReissueSslSubscription": {
"required": [
"encodedCsr"
],
"type": "object",
"properties": {
"encodedCsr": {
"type": "string",
"description": "The encoded CSR containing the new data to be used during the certificate reissue.
Any Subject Alternative Name (SAN) present in the encoded CSR will be ignored during the provisioning.
To provision SANs for multi-domain products, provide them in the 'sanEntries' field."
},
"sanEntries": {
"type": "array",
"description": "The list of SAN entries to be used during the certificate reissue.
It is only required for multi-domain certificate products and must include the encoded CSR common name.
The quantity of allowed host names depends on your original certificate order.",
"items": {
"type": "string"
}
}
},
"description": "The data required to reissue an SSL certificate."
},
"OrderSslAction": {
"type": "string",
"description": "The SSL certificate action.",
"example": "ISSUE",
"enum": [
"ISSUE",
"REISSUE",
"RENEW",
"TRANSFER"
]
}
},
"securitySchemes": {
"X-APP-ID": {
"type": "apiKey",
"description": "Your application Id provided by Namespace",
"name": "X-APP-ID",
"in": "header"
},
"X-API-KEY": {
"type": "apiKey",
"description": "Your API Key provided by Namespace",
"name": "X-API-KEY",
"in": "header"
}
}
}
}