---
title: "List Datapoint Access Events by date range"
method: GET
path: "/api/v2/consumption/events"
tags: ["Consumption"]
---

# List Datapoint Access Events by date range

`GET /api/v2/consumption/events`

Return the individual datapoint access events for the authenticated user within a date window.

**Inputs**
- `start_at` and `end_at` are **dates** (`YYYY-MM-DD`).
- Internally, `start_at` expands to the start of that day in the current Django timezone; `end_at` expands to the end of that day in the current Django timezone.

**Defaults**
- If `start_at` is omitted, it defaults to the **first day of the current month** at 00:00:00 (current timezone).
- If `end_at` is omitted, it defaults to **now** (current datetime in the current timezone).

**Behavior**
- The window is **inclusive**: `start_at ≤ timestamp ≤ end_at`.
- Results are ordered by `timestamp` ascending.

**Response**
- A paginated list of datapoint access events.

## Query parameters

- `end_at` string, date
- `limit` integer
- `offset` integer
- `start_at` string, date

## Response `200`

- PaginatedConsumptionEventList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ConsumptionEvent[], required
    - `source` string, required — Origin of the datapoint consumption event
    - `number_of_datapoints` integer, required — Number of datapoints consumed in the event
    - `user_identifier` string, required — External identifier for the user who triggered the event
    - `timestamp` string, date-time, required — Timestamp when the consumption event occurred

## Other responses

- `400`
- `401`
- `403`
- `429`

---

[API](https://skmtc.net/daloopa/apis/daloopa-api.md) · [All operations](https://skmtc.net/daloopa/apis/daloopa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/daloopa/daloopa-api/versions/746538a1eb45/schema)