---
title: "GET /mr-api/application/{appId}/feature-history"
method: GET
path: "/mr-api/application/{appId}/feature-history"
tags: ["FeatureHistoryService"]
---

# GET /mr-api/application/{appId}/feature-history

`GET /mr-api/application/{appId}/feature-history`

Gets a paginated list of history of feature value changes

## Path parameters

- `appId` string, uuid, required

## Query parameters

- `featureKeys` string[]
- `featureIds` string[]
- `versions` integer[]
- `environmentIds` string[]
- `max` integer
- `startAt` integer

## Response `200`

the webhook type details

- FeatureHistoryList
  - `max` integer — The maximum number of items returned by this query
  - `items` FeatureHistoryItem[]
    - `envId` string, uuid
    - `featureValueId` string, uuid
    - `featureId` string, uuid
    - `history` FeatureHistoryValue[]
      - `version` integer
      - `versionFrom` integer
      - `when` string, date-time — When it was created
      - `who` AnemicPerson
        - `id` string, uuid, required
        - `name` string, required
        - `type` 'person' | 'serviceAccount' | 'sdkServiceAccount', required
      - `value` unknown
      - `locked` boolean
      - `retired` boolean
      - `rolloutStrategies` RolloutStrategy[]
        - `id` string
        - `percentage` integer — value between 0 and 1000000 - for four decimal places
        - `percentageAttributes` string[] — if you don't wish to apply percentage based on user id, you can use one or more attributes defined here
        - `value` unknown
        - `attributes` object[]
          - `conditional` 'EQUALS' | 'ENDS_WITH' | 'STARTS_WITH' | 'GREATER' | 'GREATER_EQUALS' | 'LESS' | 'LESS_EQUALS' | 'NOT_EQUALS' | 'INCLUDES' | 'EXCLUDES' | 'REGEX'
          - `fieldName` string
          - `values` RolloutStrategyArrayType[] — the value(s) associated with this rule
            - unknown
          - `type` 'STRING' | 'SEMANTIC_VERSION' | 'NUMBER' | 'DATE' | 'DATETIME' | 'BOOLEAN' | 'IP_ADDRESS'
          - `id` string — A temporary id used only when validating. Saving strips these out as they are not otherwise necessary
        - `name` string, required — names are unique in a case insensitive fashion
        - `colouring` integer — the colour used to display the strategy in the UI. indexed table of background/foreground combos.
        - `avatar` string — url to avatar (if any). Not sent to SDK. Preferably a unicorn.

## Other responses

- `404` — no such url

---

[API](https://skmtc.net/featurehub-io/apis/managementresourceapi.md) · [All operations](https://skmtc.net/featurehub-io/apis/managementresourceapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/featurehub-io/managementresourceapi/versions/faed5fd616c3/schema)