---
title: "Retrieve signal v2 executions"
method: GET
path: "/v2/signals/{definitionId}/executions"
tags: ["Signals V2"]
---

# Retrieve signal v2 executions

`GET /v2/signals/{definitionId}/executions`

## Request

- Base URL: `https://api.momentum.io`
- URL: `https://api.momentum.io/v2/signals/{definitionId}/executions`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/momentum/apis/momentum-api/docs/v2/signals/:definitionId/executions/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a paginated list of signal executions (triggered signals) for a specific signal definition within a given time range.

## Path parameters

- `definitionId` integer, required

## Query parameters

- `executionFrom` string, date-time, required
- `executionTo` string, date-time
- `pageNumber` integer
- `pageSize` integer
- `includeFollowUpPrompts` boolean

## Response `200`

A paginated list of signal executions.

- object
  - `signals` SignalV2Execution[], required
    - `signalId` integer, required: The ID of the signal definition that was triggered.
    - `signalName` string, required: The name of the signal that was triggered.
    - `triggeredAt` string, date-time, required: When the signal was triggered.
    - `sourceId` integer, required: The ID of the source meeting.
    - `sourceType` 'meeting', required: The type of source that triggered the signal.
    - `sourceTitle` string, nullable, required: The title of the meeting.
    - `prompt` string, nullable, required: The prompt text that was used for the signal.
    - `reason` string, nullable, required: The AI-generated reason explaining why the signal was triggered.
    - `hostEmail` string, nullable, required: Email of the meeting host.
    - `attendeeEmails` string[], required: List of attendee emails.
    - `followUpPrompts` SignalV2FollowUpPrompt[], nullable: Follow-up prompt outputs. Only included when includeFollowUpPrompts=true.
    - `salesforceAccountId` string, nullable, required: Associated Salesforce Account ID, if any.
    - `salesforceAccountName` string, nullable, required: Associated Salesforce Account name, if any.
    - `salesforceOpportunityId` string, nullable, required: Associated Salesforce Opportunity ID, if any.
    - `salesforceOpportunityName` string, nullable, required: Associated Salesforce Opportunity name, if any.
    - `salesforceLeadId` string, nullable, required: Associated Salesforce Lead ID, if any.
    - `salesforceLeadName` string, nullable, required: Associated Salesforce Lead name, if any.
  - `pageCount` integer, required: Total number of pages available for the current query.

## Other responses

- `400`: Bad request due to validation errors
- `500`: Internal server error

---

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