---
title: "Report History"
method: GET
path: "/v3/batch/reports/history"
---

# Report History

`GET /v3/batch/reports/history`

## Request

- Base URL: `https://api.similarweb.com`
- URL: `https://api.similarweb.com/v3/batch/reports/history`
- Auth: API key in header `api-key`

Get information about all the reports that were requested.

## Query parameters

- `user_id` string
- `start_date` string
- `state` string
- `report_id` string
- `limit` string
- `offset` string

## Headers

- `api_key` string

## Response `200`

200

- object
  - `items` object[]
    - `account_id` string
    - `create_date` string
    - `credits_charged` string
    - `data_points` integer
    - `delivery_method` string
    - `end_date` string
    - `granularity` string
    - `last_updated` string
    - `processing_start_time` string
    - `product` string
    - `refunded` boolean
    - `report_id` string
    - `report_name` string
    - `retention_days` integer
    - `source` string
    - `start_date` string
    - `state` string
    - `subscription_id` unknown
    - `table` string
    - `used_quota` integer
    - `user_id` string
  - `total` integer

## Other responses

- `400`: 400
- `500`: 500

---

[API](https://skmtc.dev/similarweb/apis/batch-api-v4.md) - [All operations](https://skmtc.dev/similarweb/apis/batch-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/similarweb/apis/batch-api-v4/revisions/dac2bc41567f?raw)