GET Company Status

Description

Introduction

You can use this API as lightweight polling to check if companies have been updated without making resource-intensive queries on Export API

This API will return the latest period available for each company, when the latest model was published and when the latest datapoint was published.

Request Format

POST https://app.daloopa.com/api/v2/companies/status

Headers

Authorization: Basic API_KEY
Content-Type: application/json

Body Parameters

Parameter	Data Type	Description	Required
companies	Array of strings	List of company IDs to check status for	✅Yes

Body Example

{
	"companies": ["139", "197"]
}

Example Request

curl --request POST \
  --url 'https://app.daloopa.com/api/v2/companies/status' \
  --header 'Authorization: Basic API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
	"companies": ["139", "197"]
}'

Response

Status: 200
Output: JSON

Response Schema

Item	Data Type	Description
company_id	integer	ID of the company
latest_datapoint_created_at	string (datetime ISO 8601)	Timestamp when the latest datapoint was created
latest_period	string	Most recent reporting period (e.g., "2025Q1")
model_updated_at	string (datetime ISO 8601)	Timestamp when the model was last updated

Response Example

[
	{
		"company_id": 139,
		"latest_datapoint_created_at": "2025-04-23T07:54:05.218055Z",
		"latest_period": "2025Q1",
		"model_updated_at": "2025-04-23T08:04:48.797009Z"
	},
	{
		"company_id": 197,
		"latest_datapoint_created_at": "2025-04-23T12:52:31.829376Z",
		"latest_period": "2025Q1",
		"model_updated_at": "2025-04-23T13:02:56.807099Z"
	}
]