---
title: "Read Histories Endpoint"
method: GET
path: "/api/history"
tags: ["history"]
---

# Read Histories Endpoint

`GET /api/history`

## Request

- Base URL: `https://api.mit-llm-survey.academy` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mit-llm-survey.academy/api/history`
- Auth: none declared

Get all history entries with optional filtering

## Query parameters

- `skip` integer
- `limit` integer
- `participant_id` string, nullable
- `occupation_id` string, nullable
- `start_date` string, date-time, nullable
- `end_date` string, date-time, nullable

## Response `200`

Successful Response

- HistoryRead[]
  - `ip_address` string, nullable
  - `preview` boolean, nullable
  - `participant_id` string, nullable, required
  - `occupation_id` string, nullable, required
  - `user_agent` string, nullable
  - `browser` string, nullable
  - `os` string, nullable
  - `platform` string, nullable
  - `device_type` string, nullable
  - `viewport_width` integer, nullable
  - `viewport_height` integer, nullable
  - `screen_width` integer, nullable
  - `screen_height` integer, nullable
  - `timezone` string, nullable
  - `languages` string, nullable
  - `hardware_threads` integer, nullable
  - `device_memory` integer, nullable
  - `touch_capable` boolean, nullable
  - `cookies_enabled` boolean, nullable
  - `device_key` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend.md) - [All operations](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend/revisions/6a5ef49cfcc4?raw)