API Documentation
Endpoints
Get Scan
Fetch the details of a specific scan. If the scan status is PENDING or RUNNING, all attributes (except the scan metadata) will be empty.
GET
/
scan
/
{scan_id}
curl --request GET \
--url https://api.urldna.io/scan/{scan_id} \
--header 'Authorization: <api-key>'
{
"certificate": {
"authority_info_access": "<string>",
"authority_key_identifier": "<string>",
"basic_constraints": "<string>",
"certificate_policies": "<string>",
"ct_precert_scts": "<string>",
"extended_key_usage": "<string>",
"issuer": "<string>",
"key_usage": "<string>",
"not_after": "<string>",
"not_before": "<string>",
"serial_number": "<string>",
"subject": "<string>",
"subject_key_identifier": "<string>",
"version": 123
},
"console_messages": [
{
"text": "<string>",
"type": "<string>"
}
],
"cookies": [
{
"domain": "<string>",
"expiry": "<string>",
"http_only": true,
"name": "<string>",
"path": "<string>",
"secure": true,
"value": "<string>"
}
],
"dom": "<string>",
"favicon": {
"blob_uri": "<string>",
"format": "<string>",
"height": 123,
"mimetype": "<string>",
"name": "<string>",
"phash": "<string>",
"url": "<string>",
"width": 123
},
"http_transactions": [
{
"content_type": "<string>",
"ip": "<string>",
"method": "<string>",
"mimetypes": "<string>",
"size": 123,
"status_code": 123,
"url": "<string>"
}
],
"ip_address": {
"asn": "<string>",
"city": "<string>",
"country": "<string>",
"country_code": "<string>",
"ip": "<string>",
"isp": "<string>",
"latitude": 123,
"longitude": 123,
"org": "<string>",
"region": "<string>",
"timezone_gmt": "<string>",
"type": "<string>"
},
"malicious": {
"malicious": true,
"threat": "PHISHING"
},
"page": {
"headers": {},
"meta_tags": {},
"outgoing_links": [
"<string>"
],
"ssdeep": "<string>",
"text": "<string>",
"title": "<string>"
},
"scan": {
"id": "<string>",
"submitted_url": "<string>",
"domain": "<string>",
"target_url": "<string>",
"protocol": "<string>",
"device": "DESKTOP",
"user_agent": "<string>",
"nsfw": true,
"scanned_from": "DEFAULT",
"origin": "API",
"width": 123,
"height": 123,
"private_scan": true,
"status": "PENDING",
"submitted_date": "2023-11-07T05:31:56Z",
"submitter_tags": [
"<string>"
]
},
"scan_feedback": {
"malicious_count": 123,
"safe_count": 123
},
"scan_whois": {
"address": "<string>",
"country": "<string>",
"creation_date": "<string>",
"domain_name": "<string>",
"expiration_date": "<string>",
"name": "<string>",
"org": "<string>",
"registrant_postal_code": "<string>",
"registrar": "<string>",
"state": "<string>",
"updated_date": "<string>"
},
"screenshot": {
"blob_uri": "<string>",
"format": "<string>",
"height": 123,
"mimetype": "<string>",
"phash": "<string>",
"width": 123
},
"technologies": [
{
"category": "<string>",
"name": "<string>",
"version": "<string>"
}
]
}
Authorizations
Path Parameters
Unique identifier of the scan.
Response
200
application/json
Scan result retrieved successfully.
Represents the results of a scan performed on a URL, domain, or IP, including security, network, and content analysis.
curl --request GET \
--url https://api.urldna.io/scan/{scan_id} \
--header 'Authorization: <api-key>'
{
"certificate": {
"authority_info_access": "<string>",
"authority_key_identifier": "<string>",
"basic_constraints": "<string>",
"certificate_policies": "<string>",
"ct_precert_scts": "<string>",
"extended_key_usage": "<string>",
"issuer": "<string>",
"key_usage": "<string>",
"not_after": "<string>",
"not_before": "<string>",
"serial_number": "<string>",
"subject": "<string>",
"subject_key_identifier": "<string>",
"version": 123
},
"console_messages": [
{
"text": "<string>",
"type": "<string>"
}
],
"cookies": [
{
"domain": "<string>",
"expiry": "<string>",
"http_only": true,
"name": "<string>",
"path": "<string>",
"secure": true,
"value": "<string>"
}
],
"dom": "<string>",
"favicon": {
"blob_uri": "<string>",
"format": "<string>",
"height": 123,
"mimetype": "<string>",
"name": "<string>",
"phash": "<string>",
"url": "<string>",
"width": 123
},
"http_transactions": [
{
"content_type": "<string>",
"ip": "<string>",
"method": "<string>",
"mimetypes": "<string>",
"size": 123,
"status_code": 123,
"url": "<string>"
}
],
"ip_address": {
"asn": "<string>",
"city": "<string>",
"country": "<string>",
"country_code": "<string>",
"ip": "<string>",
"isp": "<string>",
"latitude": 123,
"longitude": 123,
"org": "<string>",
"region": "<string>",
"timezone_gmt": "<string>",
"type": "<string>"
},
"malicious": {
"malicious": true,
"threat": "PHISHING"
},
"page": {
"headers": {},
"meta_tags": {},
"outgoing_links": [
"<string>"
],
"ssdeep": "<string>",
"text": "<string>",
"title": "<string>"
},
"scan": {
"id": "<string>",
"submitted_url": "<string>",
"domain": "<string>",
"target_url": "<string>",
"protocol": "<string>",
"device": "DESKTOP",
"user_agent": "<string>",
"nsfw": true,
"scanned_from": "DEFAULT",
"origin": "API",
"width": 123,
"height": 123,
"private_scan": true,
"status": "PENDING",
"submitted_date": "2023-11-07T05:31:56Z",
"submitter_tags": [
"<string>"
]
},
"scan_feedback": {
"malicious_count": 123,
"safe_count": 123
},
"scan_whois": {
"address": "<string>",
"country": "<string>",
"creation_date": "<string>",
"domain_name": "<string>",
"expiration_date": "<string>",
"name": "<string>",
"org": "<string>",
"registrant_postal_code": "<string>",
"registrar": "<string>",
"state": "<string>",
"updated_date": "<string>"
},
"screenshot": {
"blob_uri": "<string>",
"format": "<string>",
"height": 123,
"mimetype": "<string>",
"phash": "<string>",
"width": 123
},
"technologies": [
{
"category": "<string>",
"name": "<string>",
"version": "<string>"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.