---
title: "Get card-level category trigger status"
method: GET
path: "/users/{userId}/cards/{cardId}/category-action-triggers"
tags: ["Category Action Triggers"]
---

# Get card-level category trigger status

`GET /users/{userId}/cards/{cardId}/category-action-triggers`

## Request

- Base URL: `https://east.sandbox.spade.com`
- URL: `https://east.sandbox.spade.com/users/{userId}/cards/{cardId}/category-action-triggers`
- Auth: API key in header `X-Api-Key`

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

Card-level triggers apply only to transactions for the specified card.

**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.dev/spade/apis/spade-api.md) - [All operations](https://skmtc.dev/spade/apis/spade-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spade/apis/spade-api/revisions/a37c626f84de?raw)