---
title: "Get Cost Events"
method: GET
path: "/api/v1/users/events"
tags: ["Cost Events"]
---

# Get Cost Events

`GET /api/v1/users/events`

## Request

- Base URL: `https://api.umbrellacost.io`
- URL: `https://api.umbrellacost.io/api/v1/users/events`
- Auth: none declared. Required headers: `Authorization`, `apikey`

The call is used to retrieve events created by api-key defined user

## Query parameters

- `startDate` string, required
- `endDate` string, required

## Headers

- `Authorization` string, required
- `apikey` string, required

## Response `200`

- object
  - `account_id` string: The payer account id
  - `uuid` string: The event id
  - `creation_time` string: Time and date when this event was created in format YYYY-MM-DD hh:mm:ss
  - `date` string: Date of the event in format YYYY-MM-DD
  - `description` string: The description of the event
  - `title` string: The title of the event
  - `user_key` string: Identifier of user, who created this event
  - `updating_time` string: The last time and date when this event was updated in format YYYY-MM-DD hh:mm:ss
  - `estimation` string: The $ value of the event, if specified

---

[API](https://skmtc.dev/umbrellacost/apis/advanced-services.md) - [All operations](https://skmtc.dev/umbrellacost/apis/advanced-services/llms.txt) - [OpenAPI document](https://skmtc.dev/umbrellacost/apis/advanced-services/revisions/fde38bef0656?raw)