---
title: "Get account-level category trigger status"
method: GET
path: "/category-action-triggers"
tags: ["Category Action Triggers"]
---

# Get account-level category trigger status

`GET /category-action-triggers`

Get the status and version of the latest category action trigger registration at the account scope.

Account-level triggers apply to all transactions for all users in your account.

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

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

## Response `200`

Successful operation

- CategoryActionTriggerStatusResponse — Response containing the status of a category action trigger registration.
  - `status` 'succeeded' | 'failed' — The current status of the action trigger registration. Category trigger registrations are processed synchronously, so the status is always one of: - `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.
  - `categoryTriggers` object[] — The list of active category triggers registered for this scope. Present on GET responses; omitted on PUT and PATCH responses.
    - `id` string — The trigger ID as provided during registration.
    - `categoryId` string — The category ID associated with this trigger, as provided during registration.
    - `action` object — The action data associated with this trigger, as provided during registration.
  - `totalCount` integer — The total number of active category 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)