GET Series Continuation

Description

Introduction

When analysts make corrections or merge data, Series IDs can change. When this happens, the original Series ID becomes inactive and a new Series ID is generated. If you continue querying the API with a deprecated Series ID, no data will be returned.

The Series Continuation API allows you to verify whether a Series ID is still active and retrieve its current replacement if it has been deprecated. By providing a company identifier and Series ID, you can ensure your queries always use the most current data.

This ensures you always have access to the most up-to-date data in your applications.

Definitions

SPLIT (1 → n)

A single series is split into two or more new series. This typically happens when an analyst identifies that a previously grouped series actually represents multiple distinct entities.

Example:
[23] → [24, 25]
Series 23 is split into Series 24 and Series 25.

MERGE (n → 1)

Two or more series are merged into a single new series. This is usually due to a realization that multiple series actually represent the same underlying entity or dataset.

Example:
[23, 24] → [26]
Series 23 and Series 24 are merged to form Series 26.

COMPOSITE (n → n)

One or more fundamentals from one series are moved to another, or fundamentals from multiple series are interchanged or combined to form a new set of series. This transformation may result in partial or full redistribution of data across series.

Example:
[23, 24] → [25, 26]
Data from Series 23 and 24 is redistributed and combined to create Series 25 and 26.

Request Format

GET https://app.daloopa.com/api/v2/series-continuation

Query Parameters

• Either company_id or series_id must be provided.

Example Request

curl --request GET \
  --url 'https://ap.daloopa.com/api/v2/series-continuation?company_id=2' \
  --header 'Authorization: Basic APIKEY'

Response

Status : 200

Output: JSON

Response Schema

The API returns an array of objects, where each object represents a series deprecation event. Below is the schema for each field in the response:

Top-Level Object

Series Object (used in both old_series and new_series)

Deprecation Types