logo
API docs by Redocly

Spaceship.com (1.0.0)

Download OpenAPI specification:Download

E-mail: [email protected] URL: https://www.spaceship.com/about/contact-us/

Spaceship API

Authentication

Spaceship API uses a combination of API key and API secret for authentication.

API key setup

You can generate your API key and secret in API Manager. Use the "New API key" button to set up a new API key and follow the guide to get started.
After the key setup has been successful, it should appear on the API Manager application page.

API key usage

As shown in the example below, API consumers shall pass a valid API key and a corresponding API secret in the X-API-Secret headers.
You do not need to encode the API key and the API secret.

curl -X GET '/api/resource' \
-H 'X-Api-Secret: F3brvQluT4s8aDB7PeFBH6qKHfH2xTKTneCjZbq3z2w7rj2vV6n_zhSvvJoQ' \
-H 'X-Api-Key: JdIS8QYFMZpVKupJtdc3'

Permissions

  • domains:read - Read domain information and check configuration
  • domains:write - Manage domains and domain settings
  • domains:transfer - Transfer domains in and out
  • contacts:write - Save contact details
  • contacts:read - Read contact details
  • dnsrecords:write - Write DNS resource records
  • dnsrecords:read - Read DNS resource records

Domains

Get domain list

Retrieves a paginated list of domains, allowing the use of query parameters to customize the response. This operation is essential for efficiently managing large collections of domains, enabling smooth navigation and retrieval without overloading the system with unnecessary data.

Required Permissions

Rate Limits

  • The limit for fetching a domain list is 300 requests per user, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
query Parameters
take
required
integer <int32> [ 1 .. 100 ]

Number of response items per page

skip
required
integer <int32> [ 0 .. 2147483647 ]

Number of response items to skip

orderBy
Array of strings <= 1 items
Items Enum: "name" "-name" "unicodeName" "-unicodeName" "registrationDate" "-registrationDate" "expirationDate" "-expirationDate"

Specifies fields and order to sort the response items

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/domains?take=SOME_INTEGER_VALUE&skip=SOME_INTEGER_VALUE&orderBy=SOME_ARRAY_VALUE';
const options = {
  method: 'GET',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "total": 100
}

Get domain info

Get details of a specific domain.

Required Permissions

Rate Limits

  • The limit for obtaining info for a domain is 5 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

Domain name in ASCII format (A-label) whose details are to be fetched. The domain name must be provided in a fully qualified domain format.

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/domains/spaceship.com';
const options = {
  method: 'GET',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/json
{
  • "name": "xn--spceship-9ya.com",
  • "unicodeName": "spaceship.com",
  • "isPremium": false,
  • "autoRenew": false,
  • "registrationDate": "2022-01-01T00:00:00.000Z",
  • "expirationDate": "2022-01-01T00:00:00.000Z",
  • "lifecycleStatus": "registered",
  • "verificationStatus": "success",
  • "eppStatuses": [
    ],
  • "suspensions": [
    ],
  • "privacyProtection": {
    },
  • "nameservers": {
    },
  • "contacts": {
    }
}

Delete the domain

This API is under development and currently returns an HTTP 501 status.

The provided information is for preliminary familiarization only. Once the API is implemented, this notice will be removed.

Delete the specific domain. Please note a refund will not be provided as part of this operation.

Required Permissions

Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

Domain name in ASCII format (A-label) that must be deleted. The domain name must be provided in a fully qualified domain format.

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/domains/spaceship.com';
const options = {
  method: 'DELETE',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/problem+json
{
  • "detail": "string"
}

Register the domain

This API is under development and currently returns an HTTP 501 status.

The provided information is for preliminary familiarization only. Once the API is implemented, this notice will be removed.

Register a specific domain.

Required Permissions

Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain name for registration.

Request Body schema: application/json
required
name
required
string <domain> [ 4 .. 255 ] characters

Domain name in UTF-8 format (U-label)

autoRenew
required
boolean

Indicates whether the auto-renew option is enabled

required
object

Information about domain privacy protection

required
object

Information about nameservers

required
object

Domain Contacts presented as ID references

Responses

Request samples

Content type
application/json
{
  • "name": "spaceship.com",
  • "autoRenew": false,
  • "privacyProtection": {
    },
  • "nameservers": {
    },
  • "contacts": {
    }
}

Response samples

Content type
application/problem+json
{
  • "detail": "string"
}

Update the domain autorenewal state

This API is under development and currently returns an HTTP 501 status.

The provided information is for preliminary familiarization only. Once the API is implemented, this notice will be removed.

Allows the modification of a domain's autorenewal state.

Required Permissions

Rate Limits

  • The limit for updating the autorenewal state for a domain is 5 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose autorenewal state is being updated.

Request Body schema: application/json
required

Provides the new autorenewal state for the domain.

isAutoRenewing
required
boolean

Describes autorenewal state for the domain

Responses

Request samples

Content type
application/json
{
  • "isAutoRenewing": true
}

Response samples

Content type
application/json
{
  • "isAutoRenewing": true
}

Update domain contacts

Allows the modification of domain name contacts.

Required Permissions

Rate Limits

  • The limit for updating contacts for a domain is 5 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose contacts are being updated.

Request Body schema: application/json
required

Provides the new set of contacts or the domain.

registrant
required
string [ 27 .. 32 ] characters [a-zA-Z0-9]+

ID of the registrant contact person

admin
string [ 27 .. 32 ] characters [a-zA-Z0-9]+

ID of the admin contact person

tech
string [ 27 .. 32 ] characters [a-zA-Z0-9]+

ID of the technical contact person

billing
string [ 27 .. 32 ] characters [a-zA-Z0-9]+

ID of the billing contact person

attributes
Array of strings (contactId) <= 5 items [[a-zA-Z0-9]+]

List of extended attribute contact point IDs

Responses

Request samples

Content type
application/json
{
  • "registrant": "1ZdMXpapqp9sle5dl8BlppTJXAzf5",
  • "admin": "1ZdMXpapqp9sle5dl8BlppTJXAzf5",
  • "tech": "1ZdMXpapqp9sle5dl8BlppTJXAzf5",
  • "billing": "1ZdMXpapqp9sle5dl8BlppTJXAzf5",
  • "attributes": [
    ]
}

Response samples

Content type
application/json
{
  • "verificationStatus": "success"
}

Update domain nameservers

Allows the modification of DNS settings for a specific domain by replacing its current nameservers with new ones. This operation is crucial to ensure that your domain points to the correct DNS servers, which is essential for routing traffic accurately and implementing changes in DNS management.

Required Permissions

Rate Limits

  • The limit for updating nameservers for a domain is 5 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose nameservers should be updated. The domain name must be provided in a fully qualified domain format.

Request Body schema: application/json
required

Provides the new set of nameservers for the domain. The request must include a list of nameservers that will replace the existing ones.

provider
required
string
Enum: "basic" "custom"

Nameservers provider

hosts
Array of strings <hostname> (fqdn) [ 2 .. 12 ] items [ items <hostname > [ 4 .. 255 ] characters ]

A list of nameservers to be assigned to the domain. Each nameserver must be provided in a fully qualified domain format. This field must be specified only for the "custom" provider; for the "basic" provider it should be omitted.

Responses

Request samples

Content type
application/json
{
  • "provider": "custom",
  • "hosts": [
    ]
}

Response samples

Content type
application/json
{
  • "hosts": [
    ],
  • "provider": "custom"
}

Get personal nameservers on a domain

Get the personal nameservers for a specific domain.

Personal nameservers are a combination of A records set for a specific host and glue records set for the domain on the registry.

Required Permissions

Rate Limits

  • The limit for fetching personal nameservers for a domain is 5 requests per domain within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

A domain name whose details should be fetched. The domain name must be provided in a fully qualified domain format.

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/domains/spaceship.com/personal-nameservers';
const options = {
  method: 'GET',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/json
{
  • "records": [
    ]
}

Get personal nameservers host configuration

This API is under development and currently returns an HTTP 501 status.

The provided information is for preliminary familiarization only. Once the API is implemented, this notice will be removed.

Get the configuration for personal nameservers associated with a specific domain.

Personal nameservers consist of A records for a specific host and glue records at the domain registry.

Required Permissions

Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

Domain name whose details should be fetched. The domain name must be provided in a fully qualified domain format.

currentHost
required
string <hostname> [ 1 .. 255 ] characters
Example: api.www

The host name part of the nameserver. For example, for spaceship.dev domain and ns1.spaceship.dev fully qualified name, the host is ns1.

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/domains/spaceship.com/personal-nameservers/api.www';
const options = {
  method: 'GET',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/json
{
  • "ips": [
    ]
}

Update personal nameservers host configuration

Update the configuration for personal nameservers associated with a specific domain.

If the host in the request body differs from the host in the path, this operation will rename the host and update the IP addresses, making the old host return a 404.

Personal nameservers are a combination of A records set for a specific host and glue records set for the domain on the registry.

Required Permissions

Rate Limits

  • The limit for updating the personal nameservers for a domain is 10 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain name in fully qualified format whose nameserver configuration should be updated

currentHost
required
string <hostname> [ 1 .. 255 ] characters
Example: api.www

The host name part of the nameserver. For example, for spaceship.dev domain and ns1.spaceship.dev fully qualified name, the host is ns1.

Request Body schema: application/json
required
host
required
string <hostname> [ 1 .. 255 ] characters

The host name of the personal nameserver

ips
required
Array of strings <ip> (ipAddress) [ 1 .. 16 ] items [ items <ip > <= 39 characters ]

List of IP addresses associated with the personal nameserver host

Responses

Request samples

Content type
application/json
{
  • "host": "ns1",
  • "ips": [
    ]
}

Response samples

Content type
application/json
{
  • "host": "ns1",
  • "ips": [
    ]
}

Delete personal nameservers host configuration

Delete the personal nameservers host configuration for a specific domain.

Personal nameservers are a combination of A records set for a specific host and glue records set for the domain on the registry.

Required Permissions

Rate Limits

  • The limit for deleting the personal nameservers host configuration for a domain is 10 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

Domain name in a fully qualified format whose personal nameservers host should be deleted

currentHost
required
string <hostname> [ 1 .. 255 ] characters
Example: api.www

The host name part of the nameserver. For example, for spaceship.dev domain and ns1.spaceship.dev fully qualified name, the host is ns1.

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/domains/spaceship.com/personal-nameservers/api.www';
const options = {
  method: 'DELETE',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/problem+json
{
  • "detail": "string"
}

Update domain email protection preference

Allows the modification of a domain's email protection preference.

Required Permissions

Rate Limits

  • The limit for updating the domain email protection preference for a domain is 5 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose email protection preference is being updated.

Request Body schema: application/json
required

Provides the new email protection level for the domain.

contactForm
required
boolean

Indicates whether WHOIS should display the contact form link

Responses

Request samples

Content type
application/json
{
  • "contactForm": true
}

Response samples

Content type
application/problem+json
{
  • "detail": "string"
}

Update domain privacy preference

Allows the modification of a domain's privacy preference.

Required Permissions

Rate Limits

  • The limit for updating the privacy preference for a domain is 5 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose privacy preference is being updated.

Request Body schema: application/json
required

Provides the new privacy level for the domain.

privacyLevel
required
string
Enum: "public" "high"

Describes privacy preference for the domain

userConsent
required
boolean

Expresses the user's consent for privacy changes. The operation will be performed ONLY if the flag is 'true'.

Responses

Request samples

Content type
application/json
{
  • "privacyLevel": "high",
  • "userConsent": true
}

Response samples

Content type
application/problem+json
{
  • "detail": "string"
}

Get domain auth code

Get the domain's auth code, also known as EPP code, authorization code, transfer code or Auth-Info Code.

Required Permissions

Rate Limits

  • The limit for obtaining auth codes is 5 requests per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose auth code is to be returned.

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/domains/spaceship.com/transfer/auth-code';
const options = {
  method: 'GET',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/json
{
  • "authCode": "7d5 1debf %^$%#",
  • "expires": "1970-01-01T00:00:00.000Z"
}

Update domain transfer lock

Allows the modification of a domain transfer lock.

Required Permissions

Rate Limits

  • The limit for updating the transfer lock for a domain is 5 requests per domain within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose transfer lock is being updated.

Request Body schema: application/json
required

Provides the new trnasfer lock for the domain.

isLocked
required
boolean

Describes transfer lock for the domain

Responses

Request samples

Content type
application/json
{
  • "isLocked": true
}

Response samples

Content type
application/json
{
  • "isLocked": true
}

Contacts

Save contact details

Save details for the contact and return the generated contact ID.

Required Permissions

Rate Limits

  • The limit for saving contact details is 300 requests per user, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
Request Body schema: application/json
required

Key-value pairs with contact details

firstName
required
string [ 1 .. 125 ] characters ^['A-Za-z-][\s'A-Z`a-z-]+['A-Za-z-]$|^['A-Za-...

Contact's first name

lastName
required
string [ 1 .. 125 ] characters ^['A-Za-z-][\s'A-Z`a-z-]+['A-Za-z-]$|^['A-Za-...

Contact's last name

organization
string <= 255 characters ^(?!\s)[\u0000-\u007F]{2,}(?!\s)[\u0000-\u007...

Organization/Company name

email
required
string <email> [ 3 .. 255 ] characters

Email

address1
required
string <= 255 characters ^[\d#&'()./:;A-Za-z\s-,\\]+$

Address (line 1)

address2
string <= 255 characters ^[\d#&'()./:;A-Za-z\s-,\\]+$

Address (line 2)

city
required
string <= 255 characters ^['.A-Za-z-][\s'.A-Za-z-]+['.A-Za-z-]$|^['.A-...

City

country
required
string (countryCode) = 2 characters ^[A-Z]{2}$

Country code (ISO 3166-1 alpha-2)

stateProvince
string <= 255 characters ^['A-Za-z-][\s'A-Z`a-z-]+['A-Za-z-]$|^['A-Za-...

State province name

postalCode
string <= 16 characters ^[\dA-Za-z-][\d\sA-Za-z-]+[\dA-Za-z-]$|^[\dA-...

Postal code

phone
required
string (phone) [ 7 .. 17 ] characters ^\+\d{1,3}\.\d{4,}$

Phone number

phoneExt
string <= 7 characters ^\d{0,7}$

Phone number extension

fax
string [ 7 .. 17 ] characters ^\+\d{1,3}\.\d{4,}$

Fax number

faxExt
string <= 7 characters ^\d{0,7}$

Fax number extension

taxNumber
string <taxNumber> <= 255 characters ^[\d./A-Za-z-][\d\s./A-Za-z-]+[\d./A-Za-z-]$|...

Tax number

Responses

Request samples

Content type
application/json
{
  • "firstName": "John",
  • "lastName": "Doe",
  • "organization": "My Company",
  • "email": "[email protected]",
  • "address1": "286 King St.",
  • "address2": "string",
  • "city": "San Francisco",
  • "country": "US",
  • "stateProvince": "CA",
  • "postalCode": "94107",
  • "phone": "+1.123456789",
  • "phoneExt": "256",
  • "fax": "+1.123456789",
  • "faxExt": "256",
  • "taxNumber": "123456789"
}

Response samples

Content type
application/json
{
  • "contactId": "stringstringstringstringstr"
}

Read contact details

Read details of the contact by contact ID.

Required Permissions

Rate Limits

  • The limit for listing contact details is 5 requests per contact, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
contact
required
string [ 27 .. 32 ] characters [a-zA-Z0-9]+
Example: 1ZdMXpapqp9sle5dl8BlppTJXAzf5

Contact ID

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/contacts/1ZdMXpapqp9sle5dl8BlppTJXAzf5';
const options = {
  method: 'GET',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/json
{
  • "firstName": "John",
  • "lastName": "Doe",
  • "organization": "My Company",
  • "email": "[email protected]",
  • "address1": "286 King St.",
  • "address2": "string",
  • "city": "San Francisco",
  • "country": "US",
  • "stateProvince": "CA",
  • "postalCode": "94107",
  • "phone": "+1.123456789",
  • "phoneExt": "256",
  • "fax": "+1.123456789",
  • "faxExt": "256",
  • "taxNumber": "123456789"
}

Contacts attributes

Save contact attributes

This API is under development and currently returns an HTTP 501 status.

The provided information is for preliminary familiarization only. Once the API is implemented, this notice will be removed.

Save contact attributes and return the generated contact ID.

Required Permissions

Rate Limits

  • The limit for saving contact attribute details is 300 requests per user, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
Request Body schema: application/json
required

Details

type
required
string [ 2 .. 32 ] characters \w+
euAdrLang
required
string (language) = 2 characters [a-z]{2}

Language (iso 639)

isNaturalPerson
required
boolean

Indicates if person is private individual

Responses

Request samples

Content type
application/json
Example
{
  • "type": "eu",
  • "euAdrLang": "en",
  • "isNaturalPerson": true
}

Response samples

Content type
application/json
"1ZdMXpapqp9sle5dl8BlppTJXAzf5"

Read attribute details

This API is under development and currently returns an HTTP 501 status.

The provided information is for preliminary familiarization only. Once the API is implemented, this notice will be removed.

Read attribute details by contact ID.

Required Permissions

Rate Limits

  • The limit for listing contact attribute details is 5 requests per attribute, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
contact
required
string [ 27 .. 32 ] characters [a-zA-Z0-9]+
Example: 1ZdMXpapqp9sle5dl8BlppTJXAzf5

Contact ID

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/contacts/attributes/1ZdMXpapqp9sle5dl8BlppTJXAzf5';
const options = {
  method: 'GET',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/json
Example
{
  • "type": "eu",
  • "euAdrLang": "en",
  • "isNaturalPerson": true
}

DNS records

Save resource records

Add custom DNS resource records or update TTL. Records are matched using case-insensitive comparison, except for TXT records.

Required Permissions

Rate Limits

  • The limit for saving resource record details is 300 requests per user, per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose resource records are being updated.

Request Body schema: application/json
required
force
boolean

Turn-off conflicts resolution checker and force zone update

required
Array of objects (ResourceRecordsListCreateOrUpdateItem) [ 1 .. 500 ] items

Responses

Request samples

Content type
application/json
Example
{
  • "force": true,
  • "items": [
    ]
}

Response samples

Content type
application/problem+json
{
  • "detail": "string"
}

Delete resource records

Delete custom DNS resource records. Records matched using case-insensitive comparison, except for TXT records, which are case-sensitive.

Required Permissions

Rate Limits

  • The limit for deleting resource record details is 300 requests per user, per domain, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose resource records are being deleted.

Request Body schema: application/json
required

Records

Array ([ 1 .. 500 ] items)
type
required
string [ 1 .. 5 ] characters \w+
address
required
string <ipv6> (ipV6Address) <= 39 characters

IPv6 address

name
required
string [ 1 .. 255 ] characters [a-zA-Z\-\.@\*]{1,255}

Name of resource record excluding domain name part. '@' can be used as an apex domain

Responses

Request samples

Content type
application/json
Example
[
  • {
    }
]

Response samples

Content type
application/problem+json
{
  • "detail": "string"
}

Get domain resource records list

Retrieves a paginated list of resource records, allowing the use of query parameters to customize the response. This operation is essential for efficiently managing large collections of resource records, enabling smooth navigation and retrieval without overloading the system with unnecessary data.

Required Permissions

Rate Limits

  • The limit for getting the domain resource records list is 300 requests per user, within 300 seconds.
Authorizations:
(apiKeyapiSecret)
path Parameters
domain
required
string <domain> [ 4 .. 255 ] characters
Example: spaceship.com

The domain whose resource records are being fetched.

query Parameters
take
required
integer <int32> [ 1 .. 500 ]

Number of response items per page

skip
required
integer <int32> [ 0 .. 2147483647 ]

Number of response items to skip

orderBy
Array of strings <= 1 items
Items Enum: "type" "-type" "name" "-name"

Specifies fields and order to sort the response items

Responses

Request samples 

const url = 'https://spaceship.dev/api/v1/dns/records/spaceship.com?take=SOME_INTEGER_VALUE&skip=SOME_INTEGER_VALUE&orderBy=SOME_ARRAY_VALUE';
const options = {
  method: 'GET',
  headers: {'X-API-Key': 'REPLACE_KEY_VALUE', 'X-API-Secret': 'REPLACE_KEY_VALUE'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "total": 100
}