---
title: "Get program-level trigger status"
method: GET
path: "/programs/{programId}/merchant-action-triggers"
tags: ["Merchant Action Triggers"]
---

# Get program-level trigger status

`GET /programs/{programId}/merchant-action-triggers`

Get the status and version of the latest merchant action trigger registration at the program scope.

Program-level triggers apply to all enrichment requests where the `programId` field matches this program. See [What is a program?](/reference/merchant-action-triggers-guide#what-is-a-program) for more details.

**Important:** Triggers are only applied to enrichment responses when the status is `succeeded`.

To learn more about action triggers, please read the [Merchant Action Triggers Guide](https://docs.spade.com/reference/merchant-action-triggers-guide).

## Response `200`

Successful operation

- ActionTriggerStatusResponse — Response containing the status of an action trigger registration.
  - `status` 'pending' | 'running' | 'succeeded' | 'failed' — The current status of the action trigger registration. - `pending`: Registration received, processing not yet started - `running`: Registration is being processed (for batch registrations with >100 triggers) - `succeeded`: Registration complete, triggers are now active - `failed`: Registration failed, check your request and retry
  - `version` integer — The version number of this registration. Increments with each PUT, PATCH, or DELETE request to this scope.
  - `merchantTriggers` object[] — The list of active merchant triggers registered for this scope. Present on GET responses; omitted on PUT and PATCH responses.
    - `id` string — The trigger ID as provided during registration.
    - `action` object — The action data associated with this trigger, as provided during registration.
  - `totalCount` integer — The total number of active merchant triggers registered for this scope. Present on GET responses; omitted on PUT and PATCH responses.

## Other responses

- `403` — Unauthorized
- `404` — No action triggers exist for this scope
- `500` — Unexpected Error

---

[API](https://skmtc.net/spade/apis/spade-api.md) · [All operations](https://skmtc.net/spade/apis/spade-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spade/spade-api/versions/a37c626f84de/schema)