Skip to content
Start here

List Threat Signals articles

GET/accounts/{account_id}/cloudforce-one/v2/threat-signals/articles

Lists articles from the account’s Threat Signals feeds.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
Accepted Permissions (at least one required)
Cloudforce One WriteCloudforce One Read
Path ParametersExpand Collapse
account_id: string
Query ParametersExpand Collapse
article_id: optional array of string

Repeatable article UUID filter. Returns the union of matching account-owned articles; use this to list every Threat Signals article referenced by an indicator’s sources.

cursor: optional string

Opaque cursor from a previous response’s next_cursor. When provided, pagination, ordering, totals, and article filters come from the cursor. Sending per_page, sort, include_total, or any article filter alongside it returns a 400 CursorFilterConflictError.

minLength1
feed_category: optional string

Exact feed-category filter after trimming. Omit to include every category.

feed_id: optional string

Feed UUID filter. Omit to include articles from every account feed.

formatuuid
fetched_after: optional string

Include articles fetched at or after this ISO 8601 date-time with Z or a numeric UTC offset; normalized to UTC.

formatdate-time
fetched_before: optional string

Include articles fetched at or before this ISO 8601 date-time with Z or a numeric UTC offset; normalized to UTC.

formatdate-time
include_total: optional boolean

When true on the first page, count matching articles and return an exact total. Defaults to false; cursor pages do not recalculate totals.

min_relevance: optional "low" or "medium" or "high"

Beta. Return only articles at or above this relevance band for pir_id, or for any active PIR when pir_id is omitted. Excludes articles that have not been scored.

One of the following:
"low"
"medium"
"high"
per_page: optional number

Number of articles per cursor page, from 1 to 100. Defaults to 20.

maximum100
minimum1
pir_id: optional string

Beta. Active Priority Intelligence Requirement to report, filter, and sort relevance by. Omit to use each article’s most relevant active PIR. Returns a 400 error unless the PIR is active.

formatuuid
published_after: optional string

Include articles published at or after this ISO 8601 date-time with Z or a numeric UTC offset; normalized to UTC.

formatdate-time
published_before: optional string

Include articles published at or before this ISO 8601 date-time with Z or a numeric UTC offset; normalized to UTC.

formatdate-time
read: optional boolean

Filter by read state. Accepts true, false, 1, or 0; omit to include read and unread articles.

severity: optional array of "informational" or "low" or "medium" or 2 more

Beta. Repeatable intrinsic severity band filter. An article matches any selected band, the band reported as its severity. Excludes articles without a severity. Like the severity field, severity is reported only while the account has an active Priority Intelligence Requirement; otherwise no articles match.

One of the following:
"informational"
"low"
"medium"
"high"
"critical"
sort: optional string

Sort by fetched_at, published_at, title, or relevance (beta). Prefix the field with - for descending order; defaults to -fetched_at. -relevance lists the most relevant articles first, by pir_id or by each article’s most relevant active PIR, with unscored articles last.

source_type: optional "curated" or "custom"

Filter by curated or custom feed source. Omit to include both source types.

One of the following:
"curated"
"custom"
Deprecatedtag: optional string

Legacy human-readable tag-value filter. Ignored when tag_id is supplied; prefer tag_id.

tag_applied_by: optional "ai" or "analyst" or "system"

Assignment provenance filter. When combined with tag_id or tag_category_id, the matching assignment must have this provenance.

One of the following:
"ai"
"analyst"
"system"
Deprecatedtag_category: optional string

Legacy category-name disambiguator for tag. It has no effect without tag; prefer tag_category_id.

tag_category_id: optional array of string

Repeatable tag-category UUID filter. An article matches any selected category; when tag_id is also present, the tag and category groups are ANDed.

tag_id: optional array of string

Repeatable tag UUID filter. An article matches any selected tag.

ReturnsExpand Collapse
errors: array of object { message }
message: string
result: object { articles, has_more, next_cursor, 2 more }
articles: array of object { id, dataset_id, event_id, 12 more }
id: string
formatuuid
dataset_id: string

Threat Events dataset identifier for the article redirect. Null when the account feeds dataset mapping is unavailable.

event_id: string

Threat Events event identifier associated with this article for a UI redirect. Null when no event has been linked.

feed_display_name: string
feed_id: string
formatuuid
fetched_at: string
link: string
published_at: string
read: boolean
read_at: string
relevance: object { band, pir_id, pirs }

Beta. The article’s relevance to the account’s active Priority Intelligence Requirements. Null when the article has not been scored against them, including when the account has no active PIRs, or has not been scored against the requested pir_id.

band: "low" or "medium" or "high"

Beta. How relevant the article is to a Priority Intelligence Requirement: high, medium, or low. Cloudflare may change the scores behind each band as relevance scoring is calibrated.

One of the following:
"low"
"medium"
"high"
pir_id: string

Beta. The pir_id requested from the article list, or otherwise the account’s most relevant active PIR for this article.

formatuuid
pirs: array of object { band, pir_id }

Beta. Every active PIR the article was scored against, most relevant first. Draft and deleted PIRs are excluded.

band: "low" or "medium" or "high"

Beta. How relevant the article is to a Priority Intelligence Requirement: high, medium, or low. Cloudflare may change the scores behind each band as relevance scoring is calibrated.

One of the following:
"low"
"medium"
"high"
pir_id: string
formatuuid
severity: "informational" or "low" or "medium" or 2 more

Beta. Intrinsic article severity band, from informational to critical, independent of any organisation or Priority Intelligence Requirement. Null when the account has no active Priority Intelligence Requirements, scoring has not completed, or a historic article has not entered an automatic rescore window.

One of the following:
"informational"
"low"
"medium"
"high"
"critical"
summary: string

Persisted enrichment summary. Null until enrichment produces a summary.

tags: array of object { applied_by, categoryId, uuid, value }
applied_by: "ai" or "analyst" or "system"
One of the following:
"ai"
"analyst"
"system"
categoryId: string
formatuuid
uuid: string
formatuuid
value: string
title: string
has_more: boolean
next_cursor: string
total_count: number
total_count_is_exact: boolean
success: true

List Threat Signals articles

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cloudforce-one/v2/threat-signals/articles \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
{
  "errors": [
    {
      "message": "message"
    }
  ],
  "result": {
    "articles": [
      {
        "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "dataset_id": "dataset_id",
        "event_id": "event_id",
        "feed_display_name": "feed_display_name",
        "feed_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "fetched_at": "fetched_at",
        "link": "link",
        "published_at": "published_at",
        "read": true,
        "read_at": "read_at",
        "relevance": {
          "band": "low",
          "pir_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "pirs": [
            {
              "band": "low",
              "pir_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
            }
          ]
        },
        "severity": "informational",
        "summary": "summary",
        "tags": [
          {
            "applied_by": "ai",
            "categoryId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "value": "value"
          }
        ],
        "title": "title"
      }
    ],
    "has_more": true,
    "next_cursor": "next_cursor",
    "total_count": 0,
    "total_count_is_exact": true
  },
  "success": true
}
Returns Examples
{
  "errors": [
    {
      "message": "message"
    }
  ],
  "result": {
    "articles": [
      {
        "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "dataset_id": "dataset_id",
        "event_id": "event_id",
        "feed_display_name": "feed_display_name",
        "feed_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "fetched_at": "fetched_at",
        "link": "link",
        "published_at": "published_at",
        "read": true,
        "read_at": "read_at",
        "relevance": {
          "band": "low",
          "pir_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "pirs": [
            {
              "band": "low",
              "pir_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
            }
          ]
        },
        "severity": "informational",
        "summary": "summary",
        "tags": [
          {
            "applied_by": "ai",
            "categoryId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "value": "value"
          }
        ],
        "title": "title"
      }
    ],
    "has_more": true,
    "next_cursor": "next_cursor",
    "total_count": 0,
    "total_count_is_exact": true
  },
  "success": true
}