---
title: "✨ Get entity state history"
method: GET
path: "/api/fsm/entities/{entity_name}/{entity_id}/history"
tags: ["States"]
---

# ✨ Get entity state history

`GET /api/fsm/entities/{entity_name}/{entity_id}/history`

<Card href="https://humansignal.com/goenterprise">
        <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/>
        <p style="margin-top: 10px; font-size: 14px;">
            This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
        </p>
    </Card>
Get the state history of an entity

## Path parameters

- `entity_id` integer, required
- `entity_name` string, required

## Query parameters

- `created_at_from` string
- `created_at_to` string
- `ordering` string
- `page` integer
- `page_size` integer
- `previous_state` string
- `state` string
- `transition_name` string
- `triggered_by` number

## Response `200`

- PaginatedStateModelList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` StateModel[], required
    - `context_data` unknown, required
    - `created_at` string, date-time, required
    - `id` string, uuid, required
    - `previous_state` string, nullable, required
    - `reason` string, nullable, required
    - `state` string, required
    - `transition_name` string, nullable, required
    - `triggered_by` TriggeredBy, required — A ModelSerializer that takes additional arguments for "fields", "omit" and "expand" in order to control which fields are displayed, and whether to replace simple values with complex, nested serializations
      - `email` string, email
      - `id` integer, required

---

[API](https://skmtc.dev/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.dev/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/revisions/8aba0fdc124a/schema)