---
title: "Get a position's edit history"
method: GET
path: "/api/positions/{position_heron_id}/overrides"
tags: ["Positions"]
---

# Get a position's edit history

`GET /api/positions/{position_heron_id}/overrides`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/positions/{position_heron_id}/overrides`
- Auth: API key in header `x-api-key`

Every edit made to the position, oldest first, including removed ones.

## Path parameters

- `position_heron_id` string, required

## Response `200`

Edit history

- PositionOverrides
  - `overrides` PositionOverride[]
    - `created` string, date-time
    - `created_by` string: Email of the person who made the edit
    - `heron_id` string: Heron ID of the override
    - `is_deleted` boolean, nullable
    - `latest_repayment_amount` number, nullable
    - `merchant_name` string, nullable: Funder of the edited position
    - `original_latest_repayment_amount` number, nullable
    - `original_repayment_frequency` 'not_enough_data' | 'same_day' | 'irregular' | 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'annually' | 'weekday' | 'twice_weekly' | 'null', nullable
    - `original_status` 'none' | 'active' | 'inactive' | 'defaulted' | 'potential_default' | 'renewal_active' | 'renewal_inactive' | 'new_position' | 'likely_paid_off'
    - `position_heron_id` unknown
    - `position_override_set_id` string, uuid: Shared by every edit to the same position
    - `product_type` 'mca' | 'line_of_credit' | 'reverse_consolidation' | 'revenue_share'
    - `repayment_frequency` 'not_enough_data' | 'same_day' | 'irregular' | 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'annually' | 'weekday' | 'twice_weekly' | 'null', nullable
    - `status` 'none' | 'active' | 'inactive' | 'defaulted' | 'potential_default' | 'renewal_active' | 'renewal_inactive' | 'new_position' | 'likely_paid_off' | 'null', nullable

## Other responses

- `404`: Position not found

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/positions/:position_heron_id/overrides/get.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)