Endpoint DNS

Login Get API Key

API Documentation

Our straightforward REST API allows you to programmatically manage your DNS resources.

Authentication

All API requests must be authenticated using a Bearer Token. Your API key should be included in the `Authorization` header.

You can find your API key on your dashboard.

Authorization: Bearer sk_your_api_key

Endpoints

/v1/domains

POSTCreate a Domain

Adds a new domain to your account. Subject to your plan's domain limit.

Request Body (JSON):

{
    "name": "example.com"
}

Example Request (cURL):

curl -X POST \
     -H "Authorization: Bearer sk_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{"name": "example.com"}' \
     http://endpointdns.com:8080/v1/domains

GETList Domains

Retrieves a list of all domains and their associated records in your account.

Example Request (cURL):

curl -X GET \
     -H "Authorization: Bearer sk_your_api_key" \
     http://endpointdns.com:8080/v1/domains

DELETEDelete a Domain

Permanently deletes a domain and all of its records from your account.

Example Request (cURL):

curl -X DELETE \
     -H "Authorization: Bearer sk_your_api_key" \
     http://endpointdns.com:8080/v1/domains/example.com

/v1/records

POSTCreate a DNS Record

Adds a new DNS record to one of your domains.

Request Body (JSON):

{
    "origin": "example.com",
    "record": {
        "name": "@",
        "type": "A",
        "value": "93.184.216.34",
        "ttl": 3600,
        "priority": 10
    }
}

// Note: "name" is the subdomain. Use "@" for the root domain.

// Note: "priority" is only used for MX and SRV records.

Example Request (cURL for A record):

curl -X POST \
     -H "Authorization: Bearer sk_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{ "origin": "example.com", "record": { "name": "www", "type": "A", "value": "93.184.216.34", "ttl": 3600 } }' \
     http://endpointdns.com:8080/v1/records

DELETEDelete a DNS Record

Deletes a specific DNS record from one of your domains.

Request Body (JSON):

{
    "origin": "example.com",
    "record": {
        "name": "www",
        "type": "A",
        "value": "93.184.216.34"
    }
}

// Note: The body identifies the exact record to delete.

Example Request (cURL):

curl -X DELETE \
     -H "Authorization: Bearer sk_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{ "origin": "example.com", "record": { "name": "www", "type": "A", "value": "93.184.216.34" } }' \
     http://endpointdns.com:8080/v1/records