Skip to main content
GET
/
knowledge
/
verify
Verify custom domain DNS configuration
curl --request GET \
  --url https://api.getfernand.com/knowledge/verify \
  --header 'X-API-Key: <api-key>'
import requests

url = "https://api.getfernand.com/knowledge/verify"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.getfernand.com/knowledge/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getfernand.com/knowledge/verify",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
require 'uri'
require 'net/http'

url = URI("https://api.getfernand.com/knowledge/verify")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.getfernand.com/knowledge/verify"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("X-API-Key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
using RestSharp;


var options = new RestClientOptions("https://api.getfernand.com/knowledge/verify");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-API-Key", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.get("https://api.getfernand.com/knowledge/verify")
.header("X-API-Key", "<api-key>")
.asString();
{
  "status": "verified",
  "verification": {
    "type": "CNAME",
    "name": "help.piedpiper.com",
    "value": "help.getfernand.com."
  }
}
{
"error": "<string>"
}
{
"error": "<string>"
}
Checks if the custom domain’s DNS records are properly configured to point to the knowledge base hosting infrastructure. Returns the current verification status and the required DNS configuration records. If verification succeeds, the custom domain is marked as valid and can be used to access the knowledge base. This endpoint is rate-limited to 5 requests per minute to prevent abuse.

Authorizations

X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Response

Domain verification status retrieved successfully.

status
enum<string>

Current verification status of the custom domain.

Available options:
verified,
pending
Example:

"verified"

verification
object

DNS configuration records required for domain verification.