--- title: "Matching Notification Events Route" method: GET path: "/api/notifications/matching-events" tags: ["notifications"] --- # Matching Notification Events Route `GET /api/notifications/matching-events` ## Request - Base URL: `https://platform.verbiflow.com/api/bridge` - URL: `https://platform.verbiflow.com/api/bridge/api/notifications/matching-events` - Auth: one of: - HTTP bearer and API key in header `x-flage-org-id` - HTTP bearer and API key in header `x-flage-org-slug` ## Query parameters - `event_keys` string, required - `sequence_scope_kind` 'all' | 'sequences' | 'plays' | 'inbox' - `sequence_ids` string - `play_ids` string - `reply_categories` string - `priority_bands` string - `bounce_classes` string - `schedule_ids` string - `workflow_namespaces` string[] - `first_touch_only` boolean - `window` 'all_time' | 'last_day' | 'last_3_days' | 'last_week' | 'last_2_weeks' | 'last_month' | 'last_3_months' - `exclude_delivered_for_rule` string - `limit` integer ## Response `200` Successful Response - NotificationMatchingEventsResponse - `events` union[], required - union - ReplyReceivedNotificationEvent: Durable inbound reply event with a channel-specific payload. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'reply.received', required: Inbound reply observation. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` union, required: Reply producer evidence. - EmailReplyReceivedPayload: Known fields emitted for an inbound email reply observation. - `channel` 'email', required: Email reply channel. - `conversation_message_id` integer, nullable: Durable inbox message identity for manual replies. - `instance_id` string, nullable: Durable sequence-person execution identity. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `provider_conversation_id` string, nullable: Provider conversation identity. - `provider_event_id` string, nullable: Provider event identity. - `provider_message_id` string, nullable: Provider message identity. - `reply_class` 'real_reply': Mailbox event classified as a real reply. - `reply_preview` string, nullable: Sanitized inbound body preview. - `reply_subject` string, nullable: Inbound email subject. - `sender_identifier` string, nullable: Sender email address. - `sender_name` string, nullable: Provider-supplied sender name. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - LinkedInReplyReceivedPayload: Known fields emitted for an inbound LinkedIn reply observation. - `channel` 'linkedin', required: LinkedIn reply channel. - `conversation_message_id` integer, nullable: Durable inbox message identity for manual replies. - `instance_id` string, nullable: Durable sequence-person execution identity. - `mailbox_event_id` string: Durable mailbox event identity. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `provider_conversation_id` string, nullable: Provider conversation identity. - `provider_message_id` string, nullable: Provider message identity. - `reply_class` 'real_reply': Mailbox event classified as a real reply. - `reply_preview` string, nullable: Sanitized inbound body preview. - `sender_identifier` string, nullable: Provider sender identity. - `sender_name` string, nullable: Provider-supplied sender name. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - ReplyClassifiedNotificationEvent: Durable reply event after inbox-intelligence classification. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'reply.classified', required: Classified reply observation. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` ReplyClassifiedPayload, required: Inbox-intelligence classification and recommended handling for one reply. - `attention_reason` string, nullable: Reason attention is required. - `channel` 'email' | 'linkedin', required: Classified reply channel. - `confidence` number, nullable: Classifier confidence from zero through one. - `conversation_group_id` integer, required: Durable inbox conversation group identity. - `handled_externally` boolean: Whether the reply was already handled outside the runtime. - `input_hash` string, nullable: Digest of normalized classification input. - `needs_attention` boolean: Whether a teammate should receive an attention ping. - `person_company_name` string: Best available company name. - `person_display_name` string: Best available person name. - `person_id` integer: Internal person identifier. - `person_primary_email` string: Best available person email. - `priority_band` 'hot' | 'warm' | 'neutral' | 'cold', required - `reason` string, nullable: Evidence-backed classification reason. - `recommended_action` 'reply_now' | 'book_meeting' | 'answer_question' | 'route_to_owner' | 'wait' | 'suppress' | 'ignore' | 'manual_review' - `reply_category` 'meeting_requested' | 'positive_interest' | 'pricing_or_procurement' | 'technical_or_security_question' | 'objection' | 'not_now' | 'not_interested' | 'targeting_mismatch' | 'wrong_person_or_referral' | 'unsubscribe_or_dnc' | 'delivery_failed' | 'delivery_delayed' | 'auto_reply' | 'support_or_existing_customer' | 'neutral_or_unclear', required - `reply_preview` string: Sanitized inbound body preview. - `sequence_id` string: First associated sequence identity. - `subject` string, nullable: Inbound message subject when present. - `summary` string, nullable: Concise semantic reply summary. - `urgency` 'urgent' | 'high' | 'normal' | 'low' - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - EmailBouncedNotificationEvent: Durable email delivery-status event classified as a bounce. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'email.bounced', required: Email bounce observation. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` EmailBouncedPayload, required: Inbound delivery-status event describing one email bounce. - `bounce_class` 'hard' | 'soft' | 'unknown', required: Canonical permanent, temporary, or unclassified bounce class. - `channel` 'email', required: Email delivery channel. - `diagnostic_text` string, nullable: First provider diagnostic for the bounce. - `failed_recipients` string[], required: Recipient addresses reported as failed. - `instance_id` string, nullable: Durable sequence-person execution identity. - `original_message_ids` string[], required: Original message identities referenced by the DSN. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `provider_conversation_id` string: Provider conversation identity. - `provider_event_id` string, nullable: Provider bounce-event identity. - `provider_message_id` string: Provider message identity. - `reply_preview` string: Sanitized inbound body preview. - `reply_subject` string: Inbound email subject. - `sender_identifier` string: Bounce sender email address. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `smtp_status` string, nullable: First reported SMTP status code. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - EmailSentNotificationEvent: Durable outbound email provider-boundary receipt event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'email.sent', required: Email send receipt. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` EmailSentPayload, required: Durable outbound email provider-boundary receipt. - `action_name` 'SEND_EMAIL' | 'REPLY_TO_EMAIL', required: Email action that reached a sent boundary. - `channel` 'email', required: Email outbound channel. - `chat_id` string, nullable: Provider LinkedIn chat identity. - `instance_id` string, nullable: Durable sequence-person execution identity. - `message_id` string, nullable: Provider sent-message identity. - `outcome` 'provider_submitted' | 'succeeded', required: Provider-boundary send outcome recorded by the action log. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `provider` string, nullable: Provider that executed the outbound action. - `provider_id` string, nullable: Provider-specific action receipt identity. - `provider_operation_id` string, nullable: Durable provider-operation ledger identity. - `provider_request_id` string, nullable: Provider request identity. - `sender_account_id` string, nullable: Connected sender account identity. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - EmailOpenedNotificationEvent: Durable tracked email-open event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'email.opened', required: Tracked email open. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` EmailOpenedPayload, required: First or repeated tracked email-open attribution. - `channel` 'email', required: Email engagement channel. - `engagement_type` 'open', required: Email-open event. - `first_touch` boolean, required: Whether this is the first event of this kind for the send. - `instance_id` string, nullable: Durable sequence-person execution identity. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `sender_account_id` string, nullable: Sender account attributed to the send. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - EmailClickedNotificationEvent: Durable tracked email-click event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'email.clicked', required: Tracked email click. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` EmailClickedPayload, required: First or repeated tracked email-click attribution. - `channel` 'email', required: Email engagement channel. - `engagement_type` 'click', required: Email-click event. - `first_touch` boolean, required: Whether this is the first event of this kind for the send. - `instance_id` string, nullable: Durable sequence-person execution identity. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `sender_account_id` string, nullable: Sender account attributed to the send. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `url` string, nullable: Clicked destination URL when captured. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - LinkedInConnectionAcceptedNotificationEvent: Durable LinkedIn connection-acceptance event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'linkedin.connection.accepted', required: LinkedIn connection acceptance. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` LinkedInConnectionAcceptedPayload, required: LinkedIn connection acceptance correlated to a person and account. - `channel` 'linkedin', required: LinkedIn acceptance channel. - `connection_name` string, nullable: Accepted connection display name. - `instance_id` string, nullable: Durable sequence-person execution identity. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `provider_account_id` string, nullable: Provider account on which the connection was accepted. - `provider_id` string, nullable: Provider recipient or acceptance identity. - `public_identifier` string, nullable: LinkedIn public profile identifier. - `sender_account_id` string, nullable: Connected sender account identity. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - LinkedInInviteSentNotificationEvent: Durable LinkedIn invitation provider-boundary receipt event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'linkedin.invite.sent', required: LinkedIn invite send receipt. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` LinkedInInviteSentPayload, required: Durable LinkedIn connection-request provider-boundary receipt. - `action_name` 'LINKEDIN_CONNECTION_REQUEST', required: LinkedIn connection-request action. - `channel` 'linkedin', required: LinkedIn outbound channel. - `chat_id` string, nullable: Provider LinkedIn chat identity. - `instance_id` string, nullable: Durable sequence-person execution identity. - `message_id` string, nullable: Provider sent-message identity. - `outcome` 'provider_submitted' | 'succeeded', required: Provider-boundary send outcome recorded by the action log. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `provider` string, nullable: Provider that executed the outbound action. - `provider_id` string, nullable: Provider-specific action receipt identity. - `provider_operation_id` string, nullable: Durable provider-operation ledger identity. - `provider_request_id` string, nullable: Provider request identity. - `sender_account_id` string, nullable: Connected sender account identity. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - LinkedInMessageSentNotificationEvent: Durable LinkedIn message provider-boundary receipt event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'linkedin.message.sent', required: LinkedIn message send receipt. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` LinkedInMessageSentPayload, required: Durable LinkedIn message or InMail provider-boundary receipt. - `action_name` 'SEND_LINKEDIN_MESSAGE' | 'SEND_INMAIL', required: LinkedIn message action that reached a sent boundary. - `channel` 'linkedin', required: LinkedIn outbound channel. - `chat_id` string, nullable: Provider LinkedIn chat identity. - `instance_id` string, nullable: Durable sequence-person execution identity. - `message_id` string, nullable: Provider sent-message identity. - `outcome` 'provider_submitted' | 'succeeded', required: Provider-boundary send outcome recorded by the action log. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `provider` string, nullable: Provider that executed the outbound action. - `provider_id` string, nullable: Provider-specific action receipt identity. - `provider_operation_id` string, nullable: Durable provider-operation ledger identity. - `provider_request_id` string, nullable: Provider request identity. - `sender_account_id` string, nullable: Connected sender account identity. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - PersonEnrolledNotificationEvent: Durable sequence-person enrollment event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'person.enrolled', required: Sequence enrollment event. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` PersonEnrolledPayload, required: Subject and runtime state recorded when a person enters a sequence. - `instance_id` string, nullable: Durable sequence-person execution identity. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `runtime_state` string: Initial sequence runtime state. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - PersonCompletedNotificationEvent: Durable sequence-person completed terminal event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'person.completed', required: Completed sequence instance. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` PersonCompletedPayload, required: Subject and transition state for a completed sequence instance. - `current_node_id` string, nullable: Node active at terminal transition. - `instance_id` string, nullable: Durable sequence-person execution identity. - `last_error` string, nullable: Terminal failure detail when present. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `previous_runtime_state` string, nullable: State immediately before the terminal transition. - `runtime_state` 'completed', required: Completed state. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - PersonFailedNotificationEvent: Durable sequence-person failed terminal event. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'person.failed', required: Failed sequence instance. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` PersonFailedPayload, required: Subject and transition state for a failed sequence instance. - `current_node_id` string, nullable: Node active at terminal transition. - `instance_id` string, nullable: Durable sequence-person execution identity. - `last_error` string, nullable: Terminal failure detail when present. - `person_company_name` string, nullable: Best available current company name. - `person_display_name` string, nullable: Best available person name. - `person_id` integer, nullable: Internal person identifier. - `person_identifier` string, nullable: Stable external person identifier. - `person_linkedin_url` string, nullable: Canonical LinkedIn profile URL when known. - `person_primary_email` string, nullable: Best available person email. - `person_title` string, nullable: Best available current job title. - `previous_runtime_state` string, nullable: State immediately before the terminal transition. - `runtime_state` 'failed', required: Failed state. - `sequence_id` string, nullable: Associated sequence identity. - `sequence_name` string, nullable: Associated sequence name. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - WorkflowSignalNotificationEvent: Typed notification signal committed by a Workflow Play. - `conversation_group_id` integer, nullable, required: Associated inbox conversation group when the event is reply-scoped. - `event_id` string, required: Durable notification event identity. - `event_key` 'workflow.signal', required: Workflow Play output signal. - `occurred_at` string, date-time, required: Time the source event occurred. - `payload_jsonb` union, required: Versioned durable workflow signal. - WorkflowSignalV1Payload: Version 1 schedule-origin Workflow Play signal. - `commit_id` string, required: Immutable workflow commit that produced the signal. - `conversation_key` string, nullable: Stable key grouping related deliveries into one conversation. - `facts` object, required: Namespace-defined signal facts with recursive JSON values whose meanings belong to that namespace. - `namespace` string, required: Application namespace defining the facts semantics. - `occurred_at` string, date-time, required: Original offset-aware occurrence timestamp from the durable signal. - `organization_uuid` string, required: Workspace that owns the signal. - `play_id` string, required: Play that emitted the signal. - `presentation` NotificationPresentationDocumentOutput, required: Canonical portable Presentation document accepted by the renderer. - … - `presentation_digest` string, required: Digest of the canonical Presentation document. - `recipients` union[], required: Recipients or recipient authorities for this signal. - … - `revision_id` string, required: Immutable Play revision executed by the run. - `run_id` string, required: Underlying workflow runtime run identifier. - `schedule_id` string, required: Schedule that triggered this version 1 signal. - `signal_key` string, required: Stable semantic identity of this workflow signal. - `subject_key` string, required: Stable subject identity within the namespace. - `tick_id` string, required: Schedule tick that triggered this version 1 signal. - `version` '1', required: Workflow signal contract version 1. - `workflow_play_run_id` string, required: Canonical Workflow Play run that emitted the signal. - WorkflowSignalV2Payload: Version 2 signal from a manual, API, schedule, or event-triggered Play run. - `commit_id` string, required: Immutable workflow commit that produced the signal. - `conversation_key` string, nullable: Stable key grouping related deliveries into one conversation. - `facts` object, required: Namespace-defined signal facts with recursive JSON values whose meanings belong to that namespace. - `namespace` string, required: Application namespace defining the facts semantics. - `occurred_at` string, date-time, required: Original offset-aware occurrence timestamp from the durable signal. - `occurrence_id` string, required: Stable occurrence identity across retries. - `organization_uuid` string, required: Workspace that owns the signal. - `play_id` string, required: Play that emitted the signal. - `presentation` NotificationPresentationDocumentOutput, required: Canonical portable Presentation document accepted by the renderer. - … - `presentation_digest` string, required: Digest of the canonical Presentation document. - `recipients` union[], required: Recipients or recipient authorities for this signal. - … - `revision_id` string, required: Immutable Play revision executed by the run. - `run_id` string, required: Underlying workflow runtime run identifier. - `schedule_id` string, nullable: Schedule that triggered the run when scheduled. - `signal_key` string, required: Stable semantic identity of this workflow signal. - `subject_key` string, required: Stable subject identity within the namespace. - `tick_id` string, nullable: Schedule tick that triggered the run when scheduled. - `trigger_id` string, nullable, required: Source trigger identifier when one exists. - `trigger_kind` 'manual' | 'api' | 'schedule' | 'event', required: Authority that admitted the Play run occurrence. - `version` '2', required: Workflow signal contract version 2. - `workflow_play_run_id` string, required: Canonical Workflow Play run that emitted the signal. - `sequence_id` string, nullable, required: Associated sequence identity when the event is sequence-scoped. - `total_matching` integer, required ## Other responses - `422`: Validation Error --- [API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)