Parameters
2 query
Query parameters
· 2domainstringRequiredDomain name to check.
Example
example.comforcestringOptionalSet to "true" to bypass the cache and trigger a fresh fetch.
Example
true/api/v1/vikitron/dns-records-checker
Returns the last known DNS records for the given domain. Cached responses (5 min fresh + 1 h SWR) are served without an outbound DNS lookup — the response reflects whatever scout has most recently persisted. If no records exist yet OR ?force=true is passed, a fresh DNS lookup is triggered before returning results (uncached).
vikitrongetApiV1VikitronDns-records-checker
Response schema
1 status code documented
200SuccessDNS records for the domain.
recordsobject[]RequiredList of DNS records.
Each array item:
namestringRequiredDNS record name (hostname).
Example
example.comtypestringRequiredDNS record type.
Examples
AAAAAMXCNAMETXTvaluestringRequiredDNS record value.
hostnamestringOptionalResolved hostname.
prioritynumberOptionalRecord priority (relevant for MX records).
ttlnumberOptionalTime-to-live in seconds.
createdAtDate | string | string | numberRequiredWhen the record was first seen.
One of 4:
Variant 1
Date
When the record was first seen.
Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
updatedAtDate | string | string | numberRequiredWhen the record was last refreshed.
One of 4:
Variant 1
Date
When the record was last refreshed.
Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
activebooleanRequiredWhether the record is currently active.
Response example
application/json{
"records": [
{
"name": "example.com",
"type": "A",
"value": "example_value",
"hostname": "example_hostname",
"priority": 0,
"ttl": 0,
"active": false
}
]
}Request example
GET /api/v1/vikitron/dns-records-checker
curl -X GET "https://api.bizkithub.com/api/v1/vikitron/dns-records-checker?domain=example.com&force=true" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY"Need an API key?
All BizKitHub public API endpoints require authentication via API key.