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

# Retrieve signal executions

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

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.net/momentum/apis/momentum-api.md) · [All operations](https://skmtc.net/momentum/apis/momentum-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/momentum/momentum-api/revisions/7c9ae2273788/schema)