Terminology Sync Service

List sync state records for all organizations

{
  "data": [
    {
      "organization_id": "org_nhf_oslo",
      "is_stale": false,
      "last_sync_at": "2026-03-26T06:00:00.000Z",
      "next_sync_due_at": "2026-03-26T18:00:00.000Z"
    },
    {
      "organization_id": "org_hlf",
      "is_stale": true,
      "last_sync_at": "2026-03-24T12:00:00.000Z",
      "next_sync_due_at": "2026-03-25T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 7
  }
}

Get sync state for a specific organization including last sync timestamp

{
  "organization_id": "org_nhf_oslo",
  "is_stale": false,
  "last_sync_at": "2026-03-26T06:00:00.000Z",
  "next_sync_due_at": "2026-03-26T18:00:00.000Z",
  "ttl_seconds": 43200
}

Create a sync tracking record for a new organization

{
  "organization_id": "org_nfb_bergen",
  "ttl_seconds": 43200
}

{
  "organization_id": "org_nfb_bergen",
  "is_stale": true,
  "last_sync_at": null,
  "created_at": "2026-03-26T09:40:00.000Z"
}

Update sync TTL or reset sync timestamp for an organization

{
  "ttl_seconds": 86400
}

{
  "organization_id": "org_nhf_oslo",
  "ttl_seconds": 86400,
  "updated_at": "2026-03-26T09:42:00.000Z"
}

Remove sync tracking record for an organization

{
  "organization_id": "org_nhf_oslo",
  "deleted": true
}

Trigger terminology sync only if the current data is stale (maps to syncIfStale())

{
  "organization_id": "org_hlf",
  "was_stale": true,
  "sync_triggered": true,
  "synced_at": "2026-03-26T09:43:10.000Z"
}

Force an immediate terminology sync regardless of staleness (maps to forcSync())

{
  "organization_id": "org_nhf_oslo",
  "synced_at": "2026-03-26T09:44:00.000Z",
  "updated_keys": 18,
  "duration_ms": 342
}

Check whether terminology data for an organization is currently stale (maps to isStale())

{
  "organization_id": "org_hlf",
  "is_stale": true,
  "last_sync_at": "2026-03-24T12:00:00.000Z",
  "stale_since": "2026-03-25T00:00:00.000Z"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}