---
title: "Get Alert Execution"
method: GET
path: "/v1/alerts/executions/{execution_id}"
tags: ["Alerts"]
---

# Get Alert Execution

`GET /v1/alerts/executions/{execution_id}`

Get a single alert execution result by execution ID. Use this to poll for alert results without needing a webhook.

## Path parameters

- `execution_id` string, required — Execution ID (exec_...)

## Response `200`

Successful Response

- AlertExecutionResult — Result of an alert execution. Captures the outcome of running an alert against one or more documents, including whether the alert was triggered and what matched. Attributes: alert_id: ID of the alert that was executed collection_id: Collection the alert was executed against execution_id: Unique identifier for this execution triggered: Whether the alert was triggered (i.e., retriever returned results) match_count: Number of matches found matches: List of match results (if include_matches was True) source_documents: Document IDs that triggered the alert check executed_at: When the alert was executed duration_ms: How long the execution took
  - `alert_id` string, required — ID of the alert that was executed
  - `collection_id` string, required — Collection the alert was executed against
  - `execution_id` string — Unique identifier for this execution
  - `triggered` boolean, required — Whether the alert was triggered
  - `match_count` integer, required — Number of matches found
  - `matches` AlertMatchResult[], nullable — List of match results
    - `document_id` string, required — ID of the matched document
    - `asset_id` string, nullable — Asset ID of the matched document
    - `score` number, required — Similarity/relevance score
    - `matched_features` object, nullable — Features that caused the match
    - `metadata` object, nullable — Metadata from the matched document
  - `source_documents` string[] — Document IDs that triggered the alert check
  - `executed_at` string, required — ISO 8601 timestamp when the alert was executed
  - `duration_ms` integer, required — How long the execution took in milliseconds

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/04b379bdbb7c/schema)