Delta Loads

A full load retrieves all the data for the investments and views you request. A delta load retrieves only the data that has changed since a time that you give. Delta loads let you keep a copy of the data current without reloading everything each time.

Full Loads and Delta Loads

	Full Load	Delta Load
What it returns	All the data for the investments and views in the request.	Only the rows that changed since `deltaStartTime`.
How to request it	A normal request, with no `deltaStartTime`.	The same request, with a `deltaStartTime`.
When to use it	The first time, and whenever you need a complete copy.	After a full load, to keep the copy current.

Both are requests to the same endpoint, and both are asynchronous. You submit the request, and then retrieve the results. See the Investment Details section and the Retrieve Investment Details page.

How Delta Loads Work

Two properties control a delta load.

Property	Description
`deltaStartTime`	The time to retrieve changes from, in UTC, for example `2026-07-02T14:30:00Z`. The API returns all updates from this time until the current time. If you don't pass it, the API returns the full load.
`includeUnchangedData`	How much of each changed row to return. When `true`, each changed row is returned complete, with all its fields. When `false`, each changed row contains only the fields that changed. The default is `false`.

A delta load returns changed rows only, so rows that haven't changed are not in the results. You merge the changed rows into the data you already hold. See Request Delta Load.

Find Out What Changed

The delta dates endpoint tells you which data points changed in a period, and on which dates, without retrieving the data itself. Use it to decide whether a delta load is needed, or which investments to include. It returns its answer straight away, because it isn't asynchronous. See Retrieve Delta Dates.

Supported Views

Delta loads and delta dates currently apply to the equity-financials view only.

A Typical Workflow

Run a full load. Request the view with no deltaStartTime, and store the results. Note the time of the request.
Check for changes (optional). Call the delta dates endpoint with the time of your last load, to see whether any data points changed.
Run a delta load. Request the same view again, this time with deltaStartTime set to the time of your last load.
Merge the changes. Update your stored data with the changed rows.
Repeat. Use the time of the latest load as the deltaStartTime for the next one.

Things to Consider

Times are in UTC, in the format yyyy-MM-ddTHH:mm:ssZ.
Use the same views, parameters and investments in the delta load as in the full load, so that changes can be merged.
Delta loads have the same limits as other requests, including up to 250 investments per request. See Core Concepts.
Most packages have no delta loads. For other packages, request the full data again when you need to refresh it.

In This Section

Page	Description
Retrieve Delta Dates	Find the dates on which data points changed.
Request Delta Load	Request only the data that has changed.

Next Steps

Retrieve Delta Dates to see what changed.
Request Delta Load to retrieve only the changes.
Equity: Financials for the parameters of the equity-financials view.