Retrieve summary for a list of IoCs

Retrieve summary for a list of IoCs.The request body should contain a list of IoC descriptors.

Input

Accepts a list of up to 1,000 IoC descriptors in a single POST request.

Supported IoC Types

File hashes (MD5, SHA1, SHA256), domains, URLs, and IP addresses.

Output

Returns a concise summary object for each requested IoC, intended to improve efficiency and performance for large-scale enrichments.

Large Payloads

If the response exceeds the 30MB size limit, the API provides a GCS fallback mechanism, returning an HTTP 302 Found redirect to a short-lived (15 minutes TTL) signed URL for downloading the full JSON result.

Error Handling

Batch requests follow an "all-or-nothing" approach; if any single IoC cannot be processed, the entire request will be rejected with a 400 Bad Request.

Example

POST /api/v3/iocs/summary
    Content-Type: application/json
    x-apikey: <YOUR_API_KEY>
   
    {
      "iocs": [
        {
          "type": "file",
          "id": "44d88612fea8a8f36de82e1278abb02f"
        },
        {
          "type": "domain",
          "id": "example.com"
        },
        {
          "type": "ip_address",
          "id": "8.8.8.8"
        }
      ]
    }