---
title: "Get translation history"
method: GET
path: "/api/v1/history"
tags: ["History"]
---

# Get translation history

`GET /api/v1/history`

## Request

- Base URL: `https://www.devspeak.dev`
- URL: `https://www.devspeak.dev/api/v1/history`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns paginated translation history for the authenticated caller.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Paginated translation history

- HistoryResponse
  - `success` true, required
  - `data` object, required
    - `items` HistoryItem[], required
      - `id` string, required
      - `inputText` string, required
      - `output` string, required
      - `audience` 'Junior Dev' | 'Senior Dev' | 'Tech Lead' | 'SRE' | 'Data Engineer', required
      - `context` 'Backend' | 'Frontend' | 'Mobile' | 'Data/ML' | 'DevOps', required
      - `format` 'Technical Spec' | 'Jira Tickets' | 'API Design' | 'RFC' | 'Data Model' | 'Prompt' | 'Optimize', required
      - `tone` integer, required
      - `wordCount` integer, required
      - `latencyMs` integer, required
      - `model` string
      - `provider` string
      - `createdAt` string, date-time, required
    - `total` integer
    - `offset` integer, required
    - `limit` integer, required

## Other responses

- `401`: Missing or invalid credentials
- `500`: Internal server error

---

[API](https://skmtc.dev/devspeak/apis/devspeak-api-v1.md) · [All operations](https://skmtc.dev/devspeak/apis/devspeak-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/devspeak/apis/devspeak-api-v1/revisions/7000833a5bbf?raw)