## TL;DR

Property history lives behind a different endpoint than current values, and it pages differently. Call the property history endpoint with the internal property name, page through the versions, and chunk by record set for large histories. Current-value exports never include history.

## Error

```text
(No error; the symptom is an export with current values but no historical versions, or a failed history request.)
```

## Steps

1. Confirm you are calling the property history endpoint, not the standard object read. Expected: the request targets versions, not current values.
2. Use the internal property name, verified from the properties list. Expected: no "property does not exist" errors.
3. Page through the history versions with the paging cursor. Expected: every version retrieved in order.
4. For many records, chunk the record ids and request history per chunk. Expected: no timeouts on large sets.
5. Store versions with their timestamps. Expected: a usable audit trail, not just the latest value.

## When to use

- You need when a field changed and to what.
- An agent audits field-fill quality over time.
- Compliance or debugging needs the value timeline.

## When not to use

- Current-value exports (use the standard endpoints).
- Salesforce field history (different tracking setup).

## Tool compatibility

- HubSpot CRM API property history endpoints.
- Internal property names from the properties API.

## Variant phrasings

### export missing history

Wrong endpoint; use the history endpoint.

### property history empty

History tracking may not have been enabled for that property.

## Why it happens

History is a separate data store from current values. Tools built for current values silently return no history, which looks like missing data rather than a wrong endpoint.

## Edge cases

- History retention is finite; very old versions may be gone.
- Some properties never track history; check the property's history settings.
- High-frequency updates create long version lists; filter by date range.

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_LMjjRRIec7NBGSrdIgwHcg