> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecomail.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get events for subscriber

> Retrieve a paginated list of tracker events for a given subscriber email address, sorted by ID descending.

<ParamField path="email" type="string" required>
  Subscriber's email address.
</ParamField>

<ParamField query="per_page" type="integer">
  Number of results per page. Default `20`, maximum `100`.
</ParamField>

<ParamField query="page" type="integer">
  Page number.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api2.ecomailapp.cz/subscribers/foo@bar.cz/events?per_page=10" \
    -H "key: YOUR_API_KEY" \
    -H "Content-Type: application/json"
  ```

  ```php PHP theme={null}
  $email = 'foo@bar.cz';
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, "https://api2.ecomailapp.cz/subscribers/{$email}/events?per_page=10");
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'key: YOUR_API_KEY',
      'Content-Type: application/json',
  ]);
  $response = curl_exec($ch);
  curl_close($ch);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "current_page": 1,
    "data": [
      {
        "id": 1234,
        "email": "foo@bar.cz",
        "category": "ue",
        "action": "Basket",
        "label": "Basket",
        "property": null,
        "value": "{\"data\":{\"data\":{\"action\":\"Basket\",\"products\":[]}}}",
        "timestamp": "2025-03-15T14:30:00.000000Z"
      }
    ],
    "per_page": 10,
    "total": 1
  }
  ```
</ResponseExample>