# List payment runs

> Returns your payment runs, newest first.

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


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. |
| `sort` | string | No | One of `created_at`, `updated_at`, `total_amount`. Prefix with `-` for descending. |
| `status` | string | No | Only runs with this status. |
| `created_after` | string (date-time) | No | Only those created after this time. |
| `created_before` | string (date-time) | No | Only those created before this time. |

## Responses

- **200**: A page of payment runs.
- **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": "run_3e5a7c9b1d2f4a6c8e0b2d4f6a8c0e1d",
      "object": "payment_run",
      "reference": "PR-BRIGHT-26-014",
      "status": "pending_approval",
      "created_by_type": "api",
      "invoice_ids": [
        "inv_4b1e7d2a9c3f4e5d8a6b0c1d2e3f4a5b"
      ],
      "skipped": [
        {
          "invoice_id": "inv_0a2c4e6b8d1f4a3c5e7b9d0f2a4c6e8b",
          "code": "bank_details_missing",
          "message": "The creator hasn't added bank details."
        }
      ],
      "funding_currency": "GBP",
      "totals": [
        {
          "currency": "GBP",
          "amount": 250000
        }
      ],
      "subtotal": 250000,
      "fee_rate": "2.50",
      "transaction_fee": 6250,
      "international_payment_fee": 0,
      "total_amount": 256250,
      "amount_received": 0,
      "amount_outstanding": 256250,
      "approved_by": null,
      "approved_at": null,
      "approval_url": "https://app.stridehq.ai/payments/runs?tab=runs",
      "notes": "Weekly creator payments",
      "metadata": {},
      "created_at": "2026-10-29T09:00:00Z",
      "updated_at": "2026-10-29T09:00:00Z"
    }
  ],
  "has_more": false
}
```