---
title: "Get table records history"
method: GET
path: "/table/{tableId}/record/history"
tags: ["record"]
---

# Get table records history

`GET /table/{tableId}/record/history`

Retrieve the change history of all records in a table, including field modifications and user information.

## Path parameters

- `tableId` string, required

## Response `200`

Get the history list of all records in a table

- object
  - `historyList` object[], required
    - `id` string, required
    - `tableId` string, required
    - `recordId` string, required
    - `fieldId` string, required
    - `before` object, required
      - `meta` object, required
        - `name` string, required — The name of the field. can not be duplicated in the table.
        - `type` 'singleLineText' | 'longText' | 'user' | 'attachment' | 'checkbox' | 'multipleSelect' | 'singleSelect' | 'date' | 'number' | 'rating' | 'formula' | 'rollup' | 'conditionalRollup' | 'link' | 'createdTime' | 'lastModifiedTime' | 'createdBy' | 'lastModifiedBy' | 'autoNumber' | 'button', required — The field types supported by teable.
        - `cellValueType` 'string' | 'number' | 'boolean' | 'dateTime', required — The cell value type of the field.
        - `isLookup` boolean — Whether this field is lookup field. witch means cellValue and [fieldType] is looked up from the linked table.
        - `isConditionalLookup` boolean — Whether this lookup field applies a conditional filter when resolving linked records.
        - `options` unknown
      - `data` unknown
    - `after` object, required
      - `meta` object, required
        - `name` string, required — The name of the field. can not be duplicated in the table.
        - `type` 'singleLineText' | 'longText' | 'user' | 'attachment' | 'checkbox' | 'multipleSelect' | 'singleSelect' | 'date' | 'number' | 'rating' | 'formula' | 'rollup' | 'conditionalRollup' | 'link' | 'createdTime' | 'lastModifiedTime' | 'createdBy' | 'lastModifiedBy' | 'autoNumber' | 'button', required — The field types supported by teable.
        - `cellValueType` 'string' | 'number' | 'boolean' | 'dateTime', required — The cell value type of the field.
        - `isLookup` boolean — Whether this field is lookup field. witch means cellValue and [fieldType] is looked up from the linked table.
        - `isConditionalLookup` boolean — Whether this lookup field applies a conditional filter when resolving linked records.
        - `options` unknown
      - `data` unknown
    - `createdTime` string, required
    - `createdBy` string, required
  - `userMap` object, required
  - `nextCursor` string, nullable

---

[API](https://skmtc.net/teable/apis/teable-app.md) · [All operations](https://skmtc.net/teable/apis/teable-app/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teable/teable-app/versions/7515f3b33d79/schema)