---
title: "Fetch a flat collection of hits"
method: GET
path: "/v3/hits"
tags: ["Alert V3"]
---

# Fetch a flat collection of hits

`GET /v3/hits`

Retrieve a flat array of intelligence hits across one or more alerts for bulk processing, each tagged to its parent alert.

## Query parameters

- `ids` string, required
- `taggedText` boolean

## Response `200`

output

- AlertHitsResponseV3 — Flattened array of intelligence hits across one or more alerts. Each hit includes its parent alert_id for traceability.
  - `data` object[], required — Array of hit objects with parent alert references.
    - `id` string — Unique hit identifier
    - `alert_id` string — Parent alert identifier
    - `index` integer — Numeric position within parent alert's hit list
    - `entities` object[] — Entities mentioned in this hit.
      - `id` string — Recorded Future entity ID
      - `name` string — Human-readable entity name
      - `type` string — Entity type (e.g., Malware, InternetDomainName, IpAddress, Hash, Company, MitreAttackIdentifier)
    - `document` object — Source document for this intelligence hit.
      - `source` object — Intelligence source reference.
        - `id` string — Source ID (e.g., source:ndy5_2)
        - `name` string — Source name
        - `type` string — Always 'Source'
      - `title` string — Document title
      - `url` string — URL to the original document
      - `authors` string[] — Document authors.
    - `fragment` string — Text snippet summarizing the intelligence match
    - `language` string — Document language code (e.g., eng)
    - `primary_entity` object, nullable — A Recorded Future entity reference.
      - `id` string — Recorded Future entity ID
      - `name` string — Human-readable entity name
      - `type` string — Entity type (e.g., Malware, InternetDomainName, IpAddress, Hash, Company, MitreAttackIdentifier)
    - `analyst_note` object, nullable — Associated analyst note, or null.

---

[API](https://skmtc.net/recordedfuture/apis/alert-api.md) · [All operations](https://skmtc.net/recordedfuture/apis/alert-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recordedfuture/alert-api/revisions/c8c2f68d8b60/schema)