---
title: "Get a job's hist signals"
method: GET
path: "/api/v2/siem-historical-detections/jobs/{job_id}/histsignals"
tags: ["Security Monitoring"]
---

# Get a job's hist signals

`GET /api/v2/siem-historical-detections/jobs/{job_id}/histsignals`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/siem-historical-detections/jobs/{job_id}/histsignals`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `security_monitoring_signals_read`

Get a job's hist signals.

## Path parameters

- `job_id` string, required

## Query parameters

- `filter[query]` string
- `filter[from]` string, date-time
- `filter[to]` string, date-time
- `sort` 'timestamp' | '-timestamp': The sort parameters used for querying security signals.
- `page[cursor]` string
- `page[limit]` integer

## Response `200`

OK

- SecurityMonitoringSignalsListResponse: The response object with all security signals matching the request and pagination information.
  - `data` SecurityMonitoringSignal[]: An array of security signals matching the request.
    - `attributes` SecurityMonitoringSignalAttributes: The object containing all signal attributes and their associated values.
      - `custom` object: A JSON object of attributes in the security signal.
      - `message` string: The message in the security signal defined by the rule that generated the signal.
      - `tags` string[]: An array of tags associated with the security signal.
      - `timestamp` string, date-time: The timestamp of the security signal.
    - `id` string: The unique ID of the security signal.
    - `type` 'signal': The type of event.
  - `links` SecurityMonitoringSignalsListResponseLinks: Links attributes.
    - `next` string: The link for the next set of results. **Note**: The request can also be made using the POST endpoint.
  - `meta` SecurityMonitoringSignalsListResponseMeta: Meta attributes.
    - `page` SecurityMonitoringSignalsListResponseMetaPage: Paging attributes.
      - `after` string: The cursor used to get the next results, if any. To make the next request, use the same parameters with the addition of the `page[cursor]`.

## Other responses

- `400`: Bad Request
- `403`: Not Authorized
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/api-v2.md) - [All operations](https://skmtc.dev/datadog/apis/api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/api-v2/revisions/da68bf029e4c?raw)
