# GET /simulations/{simulation_id}/runs/{simulation_run_id}/events

**List events for a simulation run**

Returns a paginated list of simulations. Use the query parameters to [page through results](https://developer.paddle.com/api-reference/about/pagination).

**Required permissions:** `notification_simulation.read`

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `simulation_id` | string | required | Paddle ID of the simulation entity to work with. |
| `simulation_run_id` | string | required | Paddle ID of the simulation run entity to work with. |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | array | optional | Return only the IDs specified. Use a comma-separated list to get multiple entities. |
| `after` | string | optional | Return entities after the specified Paddle ID when working with paginated endpoints. Used in the `meta.pagination.next` URL in responses for list operations. |
| `per_page` | integer | optional | Set how many entities are returned per page. Paddle returns the maximum number of results if a number greater than the maximum is requested. Check `meta.pagination.per_page` in the response to see how many were returned.

Default: `50`; Maximum: `200`. (Max: 200) |
| `order_by` | string | optional | Order returned entities by the specified field and direction (`[ASC]` or `[DESC]`). For example, `?order_by=id[ASC]`.

Valid fields for ordering: `id`. |

## Response (200)

- `data`: array (required)
- `meta`: object (required) — Information about this response.
  - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
  - `pagination`: object (required) — Keys used for working with paginated results.
    - `per_page`: integer (required) — Number of entities per page for this response. May differ from the number requested if the requested number is greater than the maximum.
    - `next`: string (uri) (required) — URL containing the query parameters of the original request, along with the `after` parameter that marks the starting point of the next page. Always returned, even if `has_more` is `false`.
    - `has_more`: boolean (required) — Whether this response has another page.
    - `estimated_total`: integer — Estimated number of entities for this response.

### Response example

```json
{
  "data": [
    {
      "id": "ntfsimevt_01j82hf8jrwjsf9337a35tqghp",
      "status": "success",
      "event_type": "adjustment.updated",
      "payload": {
        "id": "adj_01hvgf2s84dr6reszzg29zbvcm",
        "items": [
          {
            "id": "adjitm_01hvgf2s84dr6reszzg2gx70gj",
            "type": "partial",
            "amount": "100",
            "totals": {
              "tax": "8",
              "total": "100",
              "subtotal": "92"
            },
            "item_id": "txnitm_01hvcc94b7qgz60qmrqmbm19zw",
            "proration": null
          }
        ],
        "action": "refund",
        "reason": "error",
        "status": "pending_approval",
        "totals": {
          "fee": "5",
          "tax": "8",
          "total": "100",
          "earnings": "87",
          "subtotal": "92",
          "currency_code": "USD"
        },
        "created_at": "2024-04-15T08:48:20.239695Z",
        "updated_at": "2024-04-15T08:48:20.239695Z",
        "customer_id": "ctm_01hv6y1jedq4p1n0yqn5ba3ky4",
        "currency_code": "USD",
        "payout_totals": {
          "fee": "5",
          "tax": "8",
          "total": "100",
          "earnings": "87",
          "subtotal": "92",
          "currency_code": "USD"
        },
        "transaction_id": "txn_01hvcc93znj3mpqt1tenkjb04y",
        "subscription_id": "sub_01hvccbx32q2gb40sqx7n42430",
        "credit_applied_to_balance": null
      },
      "request": {
        "body": "{\"event_id\":\"ntfsimevt_01j82hf8jrwjsf9337a35tqghp\",\"event_type\":\"adjustment.updated\",\"occurred_at\":\"2024-09-18T12:24:47.960617Z\",\"data\":{\"id\":\"adj_01hvgf2s84dr6reszzg29zbvcm\",\"items\":[{\"id\":\"adjitm_01hvgf2s84dr6reszzg2gx70gj\",\"type\":\"partial\",\"amount\":\"100\",\"totals\":{\"tax\":\"8\",\"total\":\"100\",\"subtotal\":\"92\"},\"item_id\":\"txnitm_01hvcc94b7qgz60qmrqmbm19zw\",\"proration\":null}],\"action\":\"refund\",\"reason\":\"error\",\"status\":\"pending_approval\",\"totals\":{\"fee\":\"5\",\"tax\":\"8\",\"total\":\"100\",\"earnings\":\"87\",\"subtotal\":\"92\",\"currency_code\":\"USD\"},\"created_at\":\"2024-04-15T08:48:20.239695Z\",\"updated_at\":\"2024-04-15T08:48:20.239695Z\",\"customer_id\":\"ctm_01hv6y1jedq4p1n0yqn5ba3ky4\",\"currency_code\":\"USD\",\"payout_totals\":{\"fee\":\"5\",\"tax\":\"8\",\"total\":\"100\",\"earnings\":\"87\",\"subtotal\":\"92\",\"currency_code\":\"USD\"},\"transaction_id\":\"txn_01hvcc93znj3mpqt1tenkjb04y\",\"subscription_id\":\"sub_01hvccbx32q2gb40sqx7n42430\",\"credit_applied_to_balance\":null}}"
      },
      "response": {
        "body": "{\"status\":\"SUCCESS\",\"message\":\"Request handled by Hookdeck. Check your dashboard to inspect the request: https://dashboard.hookdeck.com/requests/req_6ob9lGLoCA2qKWS6VGXR\",\"request_id\":\"req_6ob9lGLoCA2qKWS6VGXR\"}",
        "status_code": 200
      },
      "created_at": "2024-09-18T12:24:47.960617Z",
      "updated_at": "2024-09-18T12:24:48.309530Z"
    }
  ],
  "meta": {
    "pagination": {
      "per_page": 50,
      "estimated_total": 1,
      "next": "https://api.paddle.dev/simulations/ntfsim_01j82fs5pvrdse93e1kawqy2fr/runs/ntfsimrun_01j82hf8heprevaj34ez32gmwz/events?after=ntfsimevt_01j82hf8jrwjsf9337a35tqghp",
      "has_more": false
    },
    "request_id": "f1726ebc-383d-45da-ab71-2c811b3c6ce8"
  }
}
```