# List Automation Runs

List runs for one automation.

This page documents the OpenSend-owned API contract for `GET /automations/{automation_id}/runs`.

`GET /automations/{automation_id}/runs`

## Authentication

Use a full-access OpenSend API key in the Authorization header. Dashboard session cookies are not API credentials for this root public API route.

```http
Authorization: Bearer os_YOUR_API_KEY
```

## Parameters

- `automation_id` — tenant-scoped automation ID.
- `limit` — optional page size from 1 to 100.
- `after` — optional cursor.
- `status` — optional run status filter; comma-separated statuses are accepted.

## Response

```json
{
  "object": "list",
  "data": [
    {
      "object": "automation_run",
      "id": "run_123",
      "automation_id": "auto_123",
      "status": "waiting",
      "current_step_key": "wait"
    }
  ],
  "has_more": false
}
```

## Errors

A missing or cross-tenant automation returns `404`. Runs are always filtered through the tenant-scoped automation lookup first.