SCscalekit
Triggers

Find several trigger deliveries by ID

Changed on

Finds up to 25 trigger events by message ID or event ID, and returns each one's delivery attempts across every delivery endpoint in this environment, as LookupTriggerDelivery does for one. Use this endpoint when you hold a list of IDs from your own server, for example to check which of a day's events reached you. Pass the IDs in the body, in any mix of message IDs and event IDs. Attempts in a batch result carry no response body; look one delivery up with LookupTriggerDelivery to read the bodies. Only this environment's deliveries are searched, so an ID from another environment comes back as NOT_FOUND. When reads are refused for volume partway through, that ID comes back RATE_LIMITED and the batch stops: IDs not yet looked up come back NOT_ATTEMPTED, to be sent again shortly. The call only reads, so retrying the whole request is always safe. Returns one result per ID, in the order sent, each with its outcome (FOUND with the delivery, NOT_FOUND, RATE_LIMITED, FAILED or NOT_ATTEMPTED) and a reason, plus found_count. The event payload is never returned.

post/api/v1/trigger-delivery/deliveries:batchLookup

Request

Request body

idsstring[] required

Message IDs (msg_…, sent to the endpoint as the webhook-id header) or event IDs (the payload's dedupe_key) of the trigger events to find, in any mix: at least 1 and at most 25, with no repeats. Each is 1 to 256 characters: letters, digits, ., _ and -. An attempt ID (atmpt_…) refuses the whole request.

Example request

{
  "ids": [
    "msg_2yAqUxVq4mTt8jHZ3fWbKcN1Pd0",
    "ca_5F28128748834787840.trgs_5F28128748834787841.Ev07ABCDEF12"
  ]
}

Response

Request processed; every ID has its own result in results, in the order sent, and found_count says how many were found

found_countinteger

How many of the requested IDs were found.

Example response

{
  "found_count": 24,
  "results": [
    {
      "delivery": {
        "attempts": [
          {
            "endpoint_id": "ep_123456789012345",
            "endpoint_url": "https://agent.example.com/hooks/triggers",
            "id": "atmpt_123456789012345",
            "msg_id": "msg_123456789012345",
            "response": "{\"ok\":true}",
            "response_duration_ms": 182,
            "response_status_code": 200,
            "timestamp": "2026-10-09T12:34:56Z"
          }
        ],
        "connection_id": "conn_28128748834787840",
        "connection_key_id": "salesforce-acme",
        "connection_provider": "SALESFORCE",
        "event_id": "ca_5F28128748834787840.trgs_5F28128748834787841.Ev07ABCDEF12",
        "message_timestamp": "2026-10-09T12:34:55Z",
        "msg_id": "msg_2yAqUxVq4mTt8jHZ3fWbKcN1Pd0",
        "subscription_id": "trgs_28128748834787841",
        "trigger_name": "slack_message_posted"
      },
      "id": "msg_2yAqUxVq4mTt8jHZ3fWbKcN1Pd0",
      "reason": "no trigger delivery with this id exists in this environment"
    }
  ]
}

Changes