---
title: "NEW - Get history of recommendations"
method: POST
path: "/api/v1/recommendations/history"
tags: ["Recommendations"]
---

# NEW - Get history of recommendations

`POST /api/v1/recommendations/history`

## Request

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

The call is used to retrieve historical recommendations The call supports pagination and it is recommended to use it with a date range.

## Query parameters

- `filters` string, required

## Headers

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

## Request body

- object
  - `limit` integer, required: Overall number of records to retrieve. Use "all" to get all responses without pagination
  - `pageSize` integer: Number of records to return in each response. Default and Maximum is 80 entries.
  - `startDate` string, date-time: Start date of the queried period. No default value.
  - `endDate` string, date-time: End date of the queried period. No default value.
  - `lastEvaluatedKey` string: The primary key of the last retrieved recommendation {account_id, uuid}

## Response `200`

- object
  - `data` string: The recommendation data records
  - `lastPageKey` string: The primary key of the last retrieved recommendation {account_id, uuid}

---

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