# Trigger calls API

> The trigger calls endpoints, each in TypeScript, Python, the CLI and curl.

The trigger calls endpoints, each in TypeScript, Python, the CLI and curl.

## Set up

* TypeScript

  ```bash
  npm install @reminix/sdk
  export REMINIX_API_KEY="<your API key>"
  ```

* Python

  ```bash
  pip install reminix
  export REMINIX_API_KEY="<your API key>"
  ```

* CLI

  ```bash
  npm install -g @reminix/cli
  reminix login
  ```

* curl

  ```bash
  export REMINIX_API_KEY="<your API key>"
  ```

To pass the key yourself, use `createClient({ apiKey: key })` in TypeScript or `Reminix(api_key=key)` in Python.

## List a webhook trigger’s calls

`GET /v1/scripts/{slug}/triggers/{triggerId}/calls`[ Try it in the API playground (opens in a new tab)](https://api.reminix.com/v1/docs#tag/trigger-calls/GET/scripts/{slug}/triggers/{triggerId}/calls)

Scope: `scripts:read`.

Lists a webhook trigger’s calls, newest first: when each came, whether it started a run or repeated an earlier call, why Reminix refused it, and the run.

* TypeScript

  ```ts
  import { createClient } from "@reminix/sdk";

  // Uses the REMINIX_API_KEY environment variable.
  const reminix = createClient();
  const triggerCalls = await reminix.triggerCalls.list("alert-on-failure", "trg_6a2e4a00-bdcf-4035-85b7-544eab30f470");
  console.log(triggerCalls);
  ```

* Python

  ```python
  from reminix import Reminix

  # Uses the REMINIX_API_KEY environment variable.
  reminix = Reminix()
  trigger_calls = reminix.trigger_calls.list(
      "alert-on-failure",
      "trg_6a2e4a00-bdcf-4035-85b7-544eab30f470",
  )
  print(trigger_calls)
  ```

* CLI

  ```bash
  reminix trigger-calls list \
    alert-on-failure \
    trg_6a2e4a00-bdcf-4035-85b7-544eab30f470
  ```

* curl

  ```bash
  curl -X GET "https://api.reminix.com/v1/scripts/alert-on-failure/triggers/trg_6a2e4a00-bdcf-4035-85b7-544eab30f470/calls" \
    -H "Authorization: Bearer $REMINIX_API_KEY"
  ```

**Returns:**

```json
{
  "items": [
    {
      "id": "tcl_8be3e70e-a2a4-495d-8c96-d7e82db0e2e2",
      "receivedAt": "2026-11-12T09:12:04.000Z",
      "result": "started",
      "reason": null,
      "runId": "run_a381c8e3-9778-494f-84a4-7529ebd8009a"
    }
  ],
  "nextCursor": null
}
```

| Field                              | Description                                     |
| ---------------------------------- | ----------------------------------------------- |
| `slug` string, path, required      | The slug's ID.                                  |
| `triggerId` string, path, required | The trigger's ID.                               |
| `limit` number, query              | Items per page, 1–100 (default 25).             |
| `cursor` string, query             | Opaque token from a previous page's nextCursor. |

More about this endpoint

Reminix keeps calls for 30 days.
