API docs by Redocly

Welcome to the WithoutDNS API Documentation (1.0.0)

Download OpenAPI specification:Download

Thank you for choosing WithoutDNS! This documentation will guide you through everything you need to know to work with our API.

Steps to Get Started

  1. Purchase Plan With API Enabled
    Make sure you have an active service with us. For details, check out our pricing page.

  2. Activate Your API Token
    To start using the API, you’ll need to activate an API token in your API Configuration settings.

Once your token is activated, you’re ready to integrate and explore the full capabilities of our API.

API Requests

Get Services

Returns List of Services

Authorizations:
TokenAuth

Responses

Request samples 

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://withoutdns.com/api/services',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer your_api_token'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": null,
  • "data": {
    }
}

Get Sites

Returns sites table

Authorizations:
TokenAuth
query Parameters
service-id
integer <int64>

ID of service

Responses

Request samples 

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://withoutdns.com/api/sites',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer your_api_token',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": null,
  • "data": {
    }
}

Create site

Create site

Authorizations:
TokenAuth
Request Body schema: application/json
required
service-id
integer <int64>
target_domain
required
string

Your Site URL

target_ip
string

IP Address

target_port
string

Port

source_domain
string

Server

path
string

Custom URL

allowed_ips
Array of strings[^(\d{1,3}\.){3}\d{1,3}$]

Allowed IP Addresses

string or string

Responses

Request samples

Content type
application/json
{
  • "service-id": 0,
  • "target_domain": "string",
  • "target_ip": "string",
  • "target_port": "string",
  • "source_domain": "string",
  • "path": "string",
  • "allowed_ips": [
    ],
  • "valid_until": "Never"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "message": "create_success",
  • "data": [ ]
}

Delete site

Delete site

Authorizations:
TokenAuth
query Parameters
id
string

ID of site that needs to be deleted. For mass delete use coma separeted ids.

Responses

Request samples 

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://withoutdns.com/api/sites?id=7',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'DELETE',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer your_api_token'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "delete_success",
  • "data": [ ]
}

Create trial

Create trial

Authorizations:
TokenAuth
Request Body schema: application/json
required
target_domain
required
string

Your Site URL

target_ip
string

IP Address

Responses

Request samples

Content type
application/json
{
  • "target_domain": "string",
  • "target_ip": "string"
}

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "message": "create_success",
  • "data": [ ]
}

Get Custom Domains

Returns Custom Domains table

Authorizations:
TokenAuth

Responses

Request samples 

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://withoutdns.com/api/domains',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer your_api_token'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": null,
  • "data": {
    }
}