Hoppa till innehåll
Menu and API reference

API reference

Data freshness

See when each data source was last checked and when its most recent record was published.

GET /api/v1/status
Access
Public resource
Cost
Free, and no API key needed

Check our claims yourself, without a key. checked_at shows the last successful run for the source and latest_record the freshest record in the database. Insider trading is checked every minute and short positions every three minutes.

Two kinds of update

update_mode tells you what to expect. continuous means a poller runs on a schedule and healthy reflects the latest run. on_import means the data updates when the source delivers, with no promised cadence; there healthy is null and latest_record is what to look at.

Request and response

The example shows a request against the production environment and a successful response.

Request
curl "https://firmainfo.se/api/v1/status"
Response
{
  "status": "ok",
  "datasets": [
    {
      "dataset": "insider_transactions",
      "update_mode": "continuous",
      "healthy": true,
      "checked_at": "2026-08-12T19:59:37.106Z",
      "latest_record": "2026-08-12T19:58:39+00:00"
    },
    {
      "dataset": "short_positions",
      "update_mode": "continuous",
      "healthy": true,
      "checked_at": "2026-08-12T19:58:22.222Z",
      "latest_record": "2026-08-12"
    },
    {
      "dataset": "annual_reports",
      "update_mode": "continuous",
      "healthy": true,
      "checked_at": "2026-08-12T19:49:23.312Z",
      "latest_record": null
    },
    {
      "dataset": "trademarks",
      "update_mode": "on_import",
      "healthy": null,
      "checked_at": null,
      "latest_record": "2026-08-05T19:02:10.312338+00:00"
    }
  ]
}

Continue here