Skip to main content

Report document

GET /public/v2/reports/{report_id} returns the full report: everything the analysis environment recorded during one browser visit. This page explains its sections, the fields analysts use most, and what each is good for. Start with the report overview for triage; reach for the full document when you need evidence.

The document is large and grows as new evidence types are captured. Read the fields you need and ignore the rest; see versioning.

Layout​

{
"report_id": "…", "date": "…", "status": "done", "tags": [],
"url": {}, "ip": {}, "final": {},
"submit": {}, "settings": {},
"detection": {}, "stats": {},
"summary": [], "http": [], "javascript": {}, "artifacts": {}
}
KeyWhat it holds
report_idThe report UUID.
dateWhen the analysis ran (RFC 3339). Cite it with the report ID.
statusdone for a completed analysis.
tagsTags applied by urlquery, mostly by detection rules, such as a phishing-kit family.
url, ipThe submitted URL and the IP address it resolved to.
finalThe page the browser ended on: its URL, title, and the final DOM.
submitHow the report was submitted: URL, submitter IP location, and the submitter's own tags.
settingsHow the analysis ran: visibility, device, user agent, referrer, cookies, and exit node.
detectionEvery alert raised, grouped by source. See detections.
stats.alert_countAlert totals per source.
summaryOne entry per host contacted, with request and data counts and technologies.
httpEvery HTTP transaction the browser made, in order.
javascriptScripts that loaded or were written into the page, and console output.
artifactsFiles and other objects extracted from the traffic: archives, PDFs, Windows shortcuts, Telegram bot tokens, and clipboard writes.

Two older keys may still appear in some reports: files, replaced by artifacts.files, and sensors, replaced by detection. Use the replacements.

Common objects​

Several sections reuse the same shapes.

URL, for example url, final.url, http[].url:

FieldExampleNotes
schemahttps
addrlogin.example.com/verify?id=1The URL without the scheme.
fqdnlogin.example.comFull host name.
domainexample.comRegistrable domain: the best field for grouping infrastructure.
tldcom

IP, for example ip, http[].ip: addr, port, asn, as (the AS name), country, country_code.

Content hashes, on response bodies, scripts, the DOM, and extracted files: md5, sha1, sha256, sha512, ssdeep, and tlshash, plus size, mime_type, and magic (the detected file type). Exact hashes identify identical content; ssdeep and tlshash are fuzzy hashes for near-identical content.

Prevalence, on response bodies, scripts, and the DOM: first_seen, last_seen, and times_seen across urlquery reports. A body seen thousands of times is common library code; one seen a handful of times is distinctive and worth pivoting on.

Captured content is downloaded separately​

The document holds hashes and metadata, not file contents. Body fields such as data are empty. Download a body with GET /public/v2/reports/{report_id}/resources/{hash}/content, using a hash from the document. resource_available tells you whether the content is stored; when it is false, only the metadata exists. See data retention.

final​

The page the visitor ended up on after redirects.

FieldUse it to
final.urlSee where the browser landed. A final domain different from url.domain means the visit was redirected.
final.titleRecognize impersonated brands and lure pages quickly.
final.domIdentify the rendered page. Its sha256 and dom_hash (a hash of the page's element structure) find reports with the same page or the same page template.

submit and settings​

submit records how the report was created: submit.url, submit.ip (location of the submitter, not of the target), and submit.tags, which the submitter chose. Owner details are only visible to the submitter and their team.

settings records how the browser ran, which matters when results differ between reports of the same URL:

FieldMeaning
accessVisibility: public, restricted, or private.
device_typeThe emulated device, for example desktop.
useragent, refererThe user agent and referrer sent. Phishing kits often cloak content based on these.
cookiesCookies supplied at submission, by domain.
exit_nodeThe network exit recorded for the analysis. Many sites change behavior by the visitor's country, so compare it with ip locations when results differ.
expires_atWhen the report is scheduled to expire.

summary​

One entry per host (fqdn) the browser contacted. Read it first to see the shape of a visit without walking every transaction.

FieldMeaning
fqdn, ipThe host and the IP it was reached at.
request_countRequests made to the host.
sent_data, received_dataBytes sent and received. Large uploads to an unexpected host can indicate exfiltration.
alert_countAlerts on this host's transactions.
domain_rankPopularity rank of the domain among the top million sites. A missing or low rank with a brand-like name is a warning sign.
domain_registeredRegistration date, when known. Recently registered domains are a common phishing signal.
first_seen, last_seenWhen the host was first and last seen in passive DNS, when known.
fingerprintsTechnologies detected on the host, such as a web server, CMS, or framework.

http​

Every HTTP transaction, in the order the browser made them. This is where most pivots start.

FieldMeaning
url, ipWhere the request went and which server answered.
is_navigation_requesttrue for page navigations, as opposed to images, scripts, and other resources.
resource_typeWhat the browser loaded, for example a document, script, or image.
requested_byWhat triggered the request.
date, timestamp, time_used, timingsWhen the request happened and how long each phase took.
security_statesecure, insecure, or broken TLS.
security_infoTLS details: protocol, cipher_suite, and the server certificate under cert (subject, issuer, validity, and fingerprint.sha256).
requestmethod, headers, cookies, raw, and post_data for submitted form data.
responsestatus_code, status_text, headers, cookies with their attributes, technology fingerprints, and data: the body's hashes, type, size, prevalence, and resource_available.
alertsAlerts raised on this transaction, by source.

Redirects. There is no separate redirect field. A redirect is a transaction with a 3xx status_code and a Location response header; the next transaction is the target. Pages can also redirect with JavaScript or a meta refresh, which shows as a new navigation request.

Form submissions. request.post_data on a POST shows what the page sent. Credential-harvesting pages often post to a different host than the one that served the form.

Strong pivots. A certificate fingerprint.sha256, a response body sha256 with a low times_seen, a distinctive cookie name, or an uncommon fqdn. Search for them with the search syntax or pivot in the Host Profile API.

javascript​

KeyContents
scriptEvery script that loaded: external scripts with their url and ip, and inline scripts (is_inline). Each has content hashes, prevalence, and alerts.
writeContent injected with document.write, a common obfuscation step.
evalCode passed to eval, recorded in older reports.
consoleBrowser console messages: level, text, filename, line_number, column_number. Errors here can reveal broken or tampered kits and the endpoints they tried to reach.

Script content is downloaded like other resources, by its sha256.

artifacts​

Objects extracted from the traffic. Each has the URL and IP it came from, content hashes, and its own alerts.

KeyContents
filesDownloaded files with type and size. Archives list their contents in archive, with each entry's path, file name, modification time, and hashes.
pdfsPDF documents with meta (author, title, producer, creator, page count) and extracted_urls with the page each link was on.
windows_shortcutsWindows .lnk files with header details and string_data, including command_line_arguments: often the actual payload command.
telegramTelegram bot tokens found in page code, whether each is_revoked, and, when resolved, the bot and its chat: names, chat ID, member counts, and administrators. Phishing kits commonly exfiltrate stolen credentials to Telegram.
clipboardText the page wrote to the clipboard, with its source. "Paste this command" lures show up here.

Extracted files, PDFs, shortcuts, and tokens are strong indicators: they rarely appear on legitimate pages and are specific to a campaign.

What you may not see​

The document is filtered for your account before it is returned:

  • Owner details in submit are visible only to the submitter and their team.
  • Alerts from private detection rules are visible only to the rule's owner, or their team when the rule is shared with it.
  • Some alert sources and some JavaScript alert details depend on your account's permissions.

Two reports of the same URL can differ because the analysis settings differed or because the site changed its behavior. Compare settings, date, and final before drawing conclusions.