# List events

> Returns events from the last 30 days, newest first.

```
GET https://api.sandbox.stridehq.ai/v1/events
```

Not available yet: this endpoint is planned.

Scope: `read`

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | No | How many to return. 1 to 100. |
| `starting_after` | string | No | The last id from the previous page. Use it when `has_more` is true. |
| `type` | string | No | Only events of this type, for example `payment_run.funded`. |

## Responses

- **200**: A page of events.
- **400**: `unknown_field`, `invalid_parameter` or `invalid_cursor`.
- **401**: `missing_api_key`, `invalid_api_key`, `revoked_api_key` or `wrong_environment`.

```json
{
  "object": "list",
  "data": [
    {
      "id": "evt_9a1c3e5b7d9f4b6a8c0e2a4c6e8a0b2d",
      "object": "event",
      "type": "payment_run.funded",
      "created_at": "2026-10-30T08:02:00Z",
      "api_version": "v1",
      "data": {
        "object": {
          "id": "run_3e5a7c9b1d2f4a6c8e0b2d4f6a8c0e1d",
          "object": "payment_run",
          "status": "funded"
        }
      }
    }
  ],
  "has_more": false
}
```
