---
title: "Retrieve signal executions"
method: GET
path: "/v1/signals/{promptId}/executions"
tags: ["Signals V1"]
---

# Retrieve signal executions

`GET /v1/signals/{promptId}/executions`

## Request

- Base URL: `https://api.momentum.io`
- URL: `https://api.momentum.io/v1/signals/{promptId}/executions`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/momentum/apis/momentum-api/docs/v1/signals/:promptId/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 prompt within a given time range.

## Path parameters

- `promptId` integer, required

## Query parameters

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

## Response `200`

A paginated list of signal executions.

- object
  - `signals` SignalExecution[], required
    - union: An execution of a signal prompt, triggered by either a meeting or an email.
      - SignalExecutionMeeting: Common fields for all signal executions.
        - `signalId` integer, required: The ID of the signal prompt 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` string, required: The ID of the source (meeting ID or email message ID).
        - `sourceTitle` string, nullable, required: The title of the meeting or subject of the email.
        - `prompt` string, required: The prompt text that was used for the signal.
        - `reason` string, nullable, required: The AI-generated reason explaining why the signal was triggered.
        - `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.
        - `customInstructions` SignalCustomInstruction[], nullable: Custom instruction outputs from follow-up prompts. Only included when includeCustomInstructions=true.
        - `sourceType` string, required: Indicates this signal was triggered by a meeting.
        - `hostEmail` string, nullable, required: Email of the meeting host.
        - `attendeeEmails` string[], required: List of attendee emails.
      - SignalExecutionEmail: Common fields for all signal executions.
        - `signalId` integer, required: The ID of the signal prompt 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` string, required: The ID of the source (meeting ID or email message ID).
        - `sourceTitle` string, nullable, required: The title of the meeting or subject of the email.
        - `prompt` string, required: The prompt text that was used for the signal.
        - `reason` string, nullable, required: The AI-generated reason explaining why the signal was triggered.
        - `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.
        - `customInstructions` SignalCustomInstruction[], nullable: Custom instruction outputs from follow-up prompts. Only included when includeCustomInstructions=true.
        - `sourceType` string, required: Indicates this signal was triggered by an email.
        - `emailFrom` string, nullable, required: Sender email address.
        - `emailTo` string[], required: List of recipient email addresses.
        - `emailCc` string[], required: List of CC email addresses.
        - `emailBcc` string[], required: List of BCC email addresses.
        - `emailThreadId` integer, nullable, required: Email thread ID.
  - `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)