---
title: "Check Company Model Status"
method: POST
path: "/api/v2/companies/status"
tags: ["Companies"]
---

# Check Company Model Status

`POST /api/v2/companies/status`

Check the data freshness signals for specified companies. Each company entry in the response distinguishes three timestamps:

- `latest_datapoint_created_at`: when the latest publish notification for the company was created. Falls back to the company's live Excel model `created_at` when no active non-clientview notification exists.
- `latest_datapoint_updated_at`: the latest data change for the company, computed as the max of the most recent DELETE event in FundamentalEventLog and the most recent incremental-update error in FundamentalErrors.
- `model_updated_at`: when the company's Excel model was last touched.

## Request body

- CompanyStatusQueryRequest
  - `companies` integer[], required — List of company ids to check status for

## Response `200`

- CompanyStatus[]
  - `company_id` integer, required — Unique identifier for the company
  - `latest_datapoint_created_at` string, date-time, nullable, required — Timestamp when the latest publish notification for the company was created. Falls back to the company's live Excel model `created_at` when no active non-clientview notification exists.
  - `latest_datapoint_updated_at` string, date-time, nullable, required — Timestamp of the latest data change for the company: max of the most recent DELETE event in FundamentalEventLog and the most recent incremental-update error in FundamentalErrors. Null if neither exists.
  - `latest_period` string, nullable, required — Most recent period for which data exists.
  - `model_updated_at` string, date-time, nullable, required — Timestamp when the company's Excel model was last touched.

## Other responses

- `400`
- `401`
- `429`

---

[API](https://skmtc.net/daloopa/apis/daloopa-api.md) · [All operations](https://skmtc.net/daloopa/apis/daloopa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/daloopa/daloopa-api/versions/746538a1eb45/schema)