Get a DNS request by id
curl -X GET "https://mail.haltman.io/api/admin/dns-requests/123" \
-H "Content-Type: application/json"
import requests
import json
url = "https://mail.haltman.io/api/admin/dns-requests/123"
headers = {
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://mail.haltman.io/api/admin/dns-requests/123", {
method: "GET",
headers: {
"Content-Type": "application/json"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://mail.haltman.io/api/admin/dns-requests/123", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://mail.haltman.io/api/admin/dns-requests/123')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
response = http.request(request)
puts response.body
{
"item": {
"id": 123,
"target": "example_string",
"type": "UI",
"status": "example_string",
"created_at": "2024-12-25T10:00:00Z",
"updated_at": "2024-12-25T10:00:00Z",
"activated_at": "2024-12-25T10:00:00Z",
"last_checked_at": "2024-12-25T10:00:00Z",
"next_check_at": "2024-12-25T10:00:00Z",
"last_check_result_json": {},
"fail_reason": "example_string",
"expires_at": "2024-12-25T10:00:00Z"
}
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Forbidden",
"message": "You don't have permission to access this resource",
"code": 403
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "example_string",
"where": "example_string",
"reason": "example_string"
}
GET
/api/admin/dns-requests/{id}GET
API Key (cookie: __Host-access)
__Host-accessstring
RequiredAccess-session cookie used for user and admin authentication.
Access-session cookie used for user and admin authentication.
path
idinteger
RequiredResource identifier.
Request Preview
Response
Response will appear here after sending the request
Authentication
path
parameterstring
RequiredAPI Key for authentication. Access-session cookie used for user and admin authentication.
Path Parameters
idinteger
RequiredResource identifier.
Responses
itemobject
Requiredidinteger
Requiredtargetstring
Requiredtypestring
RequiredAllowed values:
UIEMAILstatusstring
Requiredcreated_atstring
Requiredupdated_atstring
Requiredactivated_atstring
last_checked_atstring
next_check_atstring
last_check_result_jsonstring
fail_reasonstring
expires_atstring
Requirederrorstring
Requirederrorstring
Requirederrorstring
Requirederrorstring
Requiredwherestring
reasonstring
Was this page helpful?
Last updated Apr 9, 2026
Built with Documentation.AI