> For the complete documentation index, see [llms.txt](https://docs.jua.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jua.ai/api-v2/query-engine/open-api-reference/status.md).

# Status

## GET /v1/status/subjects

> List published forecast-status subjects

```json
{"openapi":"3.1.0","info":{"title":"Jua Query Engine API","version":"0.1.0"},"tags":[],"servers":[{"url":"https://query.jua.ai","description":"Production"}],"security":[{"HTTPBearer":[]}],"paths":{"/v1/status/subjects":{"get":{"tags":["status"],"summary":"List published forecast-status subjects","operationId":"get_subjects_v1_status_subjects_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectsResponse"}}}}}}}},"components":{"schemas":{"SubjectsResponse":{"properties":{"subjects":{"items":{"$ref":"#/components/schemas/SubjectInfo"},"type":"array","title":"Subjects"}},"type":"object","title":"SubjectsResponse"},"SubjectInfo":{"properties":{"key":{"type":"string","title":"Key"},"kind":{"type":"string","enum":["weather","power","provider"],"title":"Kind"},"display_name":{"type":"string","title":"Display Name"},"published":{"type":"boolean","title":"Published"},"schedule":{"oneOf":[{"$ref":"#/components/schemas/WeatherSubjectSchedule"},{"$ref":"#/components/schemas/PowerSubjectSchedule"},{"$ref":"#/components/schemas/ProviderSubjectSchedule"}],"title":"Schedule","discriminator":{"propertyName":"kind","mapping":{"power":"#/components/schemas/PowerSubjectSchedule","provider":"#/components/schemas/ProviderSubjectSchedule","weather":"#/components/schemas/WeatherSubjectSchedule"}}}},"type":"object","required":["key","kind","display_name","published","schedule"],"title":"SubjectInfo"},"WeatherSubjectSchedule":{"properties":{"kind":{"type":"string","const":"weather","title":"Kind","default":"weather"},"init_schedule":{"type":"string","title":"Init Schedule","description":"5-field cron for which dates the model runs."},"runs":{"items":{"$ref":"#/components/schemas/WeatherRunClock"},"type":"array","title":"Runs"}},"type":"object","required":["init_schedule","runs"],"title":"WeatherSubjectSchedule"},"WeatherRunClock":{"properties":{"init_clock":{"type":"string","title":"Init Clock","description":"UTC ``HH:MM`` of the run's init."},"communicated_complete_clock":{"type":"string","title":"Communicated Complete Clock","description":"UTC ``HH:MM`` the run is communicated to complete, on the caller's track."},"communicated_complete_day_offset":{"type":"integer","title":"Communicated Complete Day Offset","description":"Days after the init date the communicated clock falls on (0, 1, 5…)."}},"type":"object","required":["init_clock","communicated_complete_clock","communicated_complete_day_offset"],"title":"WeatherRunClock"},"PowerSubjectSchedule":{"properties":{"kind":{"type":"string","const":"power","title":"Kind","default":"power"},"cadence_minutes":{"type":"integer","title":"Cadence Minutes"},"communicated_complete_after_minutes":{"type":"integer","title":"Communicated Complete After Minutes"}},"type":"object","required":["cadence_minutes","communicated_complete_after_minutes"],"title":"PowerSubjectSchedule"},"ProviderSubjectSchedule":{"properties":{"kind":{"type":"string","const":"provider","title":"Kind","default":"provider"},"cadence_minutes":{"type":"integer","title":"Cadence Minutes"},"communicated_complete_after_minutes":{"type":"integer","title":"Communicated Complete After Minutes"},"stream_display_name":{"type":"string","title":"Stream Display Name"}},"type":"object","required":["cadence_minutes","communicated_complete_after_minutes","stream_display_name"],"title":"ProviderSubjectSchedule"}}}}
```

## GET /v1/status/summary

> Per-subject status summary for the caller's audience

```json
{"openapi":"3.1.0","info":{"title":"Jua Query Engine API","version":"0.1.0"},"tags":[],"servers":[{"url":"https://query.jua.ai","description":"Production"}],"security":[{"HTTPBearer":[]}],"paths":{"/v1/status/summary":{"get":{"tags":["status"],"summary":"Per-subject status summary for the caller's audience","operationId":"get_summary_v1_status_summary_get","parameters":[{"name":"subjects","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Subjects"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"SummaryResponse":{"properties":{"subjects":{"items":{"$ref":"#/components/schemas/SubjectSummary"},"type":"array","title":"Subjects"}},"type":"object","title":"SummaryResponse"},"SubjectSummary":{"properties":{"key":{"type":"string","title":"Key"},"kind":{"type":"string","enum":["weather","power","provider"],"title":"Kind"},"display_name":{"type":"string","title":"Display Name"},"state":{"type":"string","enum":["ok","delayed","outage","notice"],"title":"State"},"latest_run":{"anyOf":[{"$ref":"#/components/schemas/CustomerRunStatus"},{"type":"null"}]},"next_expected":{"anyOf":[{"$ref":"#/components/schemas/NextExpected"},{"type":"null"}]},"active_notice":{"anyOf":[{"$ref":"#/components/schemas/ActiveNotice"},{"type":"null"}]},"reachability":{"anyOf":[{"$ref":"#/components/schemas/ProviderReachability"},{"type":"null"}]}},"type":"object","required":["key","kind","display_name","state","latest_run","next_expected","active_notice"],"title":"SubjectSummary"},"CustomerRunStatus":{"properties":{"subject_key":{"type":"string","title":"Subject Key"},"init_time":{"type":"string","format":"date-time","title":"Init Time"},"status":{"type":"string","enum":["scheduled","running","delayed","complete"],"title":"Status"},"on_time":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Time"},"late_minutes":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Late Minutes"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"communicated_complete":{"type":"string","format":"date-time","title":"Communicated Complete"},"attribution":{"anyOf":[{"$ref":"#/components/schemas/CustomerAttribution"},{"type":"null"}]}},"type":"object","required":["subject_key","init_time","status","on_time","late_minutes","started_at","completed_at","communicated_complete"],"title":"CustomerRunStatus","description":"What one customer track sees for a run. Returned verbatim by query-engine.\n\nTimestamps are on the track's clock (standard weather = internal +30). No\ninternal targets or thresholds are present."},"CustomerAttribution":{"properties":{"title":{"type":"string","title":"Title"},"message":{"type":"string","title":"Message"}},"type":"object","required":["title","message"],"title":"CustomerAttribution","description":"Customer-facing attribution on a run: title + message, visible reasons only."},"NextExpected":{"properties":{"init_time":{"type":"string","format":"date-time","title":"Init Time"},"communicated_complete":{"type":"string","format":"date-time","title":"Communicated Complete"}},"type":"object","required":["init_time","communicated_complete"],"title":"NextExpected"},"ActiveNotice":{"properties":{"message":{"type":"string","title":"Message"},"severity":{"type":"string","enum":["info","minor","major"],"title":"Severity"},"since":{"type":"string","format":"date-time","title":"Since"}},"type":"object","required":["message","severity","since"],"title":"ActiveNotice"},"ProviderReachability":{"properties":{"reachable":{"type":"boolean","title":"Reachable"},"since":{"type":"string","format":"date-time","title":"Since","description":"When ``reachable`` last flipped: the outage start while unreachable, the recovery time while reachable."}},"type":"object","required":["reachable","since"],"title":"ProviderReachability","description":"Debounced HTTP reachability of a ``provider:*`` subject.\n\nProjected from the ``forecast_status_provider_probe`` row: no probe\nverdicts, status codes, or failure counts leave the building."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## GET /v1/status/runs

> Customer-facing run statuses, newest first

```json
{"openapi":"3.1.0","info":{"title":"Jua Query Engine API","version":"0.1.0"},"tags":[],"servers":[{"url":"https://query.jua.ai","description":"Production"}],"security":[{"HTTPBearer":[]}],"paths":{"/v1/status/runs":{"get":{"tags":["status"],"summary":"Customer-facing run statuses, newest first","operationId":"get_runs_v1_status_runs_get","parameters":[{"name":"subjects","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Subjects"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Window start, inclusive: the window is half-open `[since, before)`. Runs and attributions whose lifetime overlaps the window are returned. Defaults to 7 days before `before`; a window longer than 90 days is shortened to the 90 days ending at `before`.","title":"Since"},"description":"Window start, inclusive: the window is half-open `[since, before)`. Runs and attributions whose lifetime overlaps the window are returned. Defaults to 7 days before `before`; a window longer than 90 days is shortened to the 90 days ending at `before`."},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Window end, exclusive: the window is half-open `[since, before)`, so a run initialised exactly at `before` is not returned. Defaults to now.","title":"Before"},"description":"Window end, exclusive: the window is half-open `[since, before)`, so a run initialised exactly at `before` is not returned. Defaults to now."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"RunsResponse":{"properties":{"runs":{"items":{"$ref":"#/components/schemas/CustomerRunStatus"},"type":"array","title":"Runs"}},"type":"object","title":"RunsResponse"},"CustomerRunStatus":{"properties":{"subject_key":{"type":"string","title":"Subject Key"},"init_time":{"type":"string","format":"date-time","title":"Init Time"},"status":{"type":"string","enum":["scheduled","running","delayed","complete"],"title":"Status"},"on_time":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Time"},"late_minutes":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Late Minutes"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"communicated_complete":{"type":"string","format":"date-time","title":"Communicated Complete"},"attribution":{"anyOf":[{"$ref":"#/components/schemas/CustomerAttribution"},{"type":"null"}]}},"type":"object","required":["subject_key","init_time","status","on_time","late_minutes","started_at","completed_at","communicated_complete"],"title":"CustomerRunStatus","description":"What one customer track sees for a run. Returned verbatim by query-engine.\n\nTimestamps are on the track's clock (standard weather = internal +30). No\ninternal targets or thresholds are present."},"CustomerAttribution":{"properties":{"title":{"type":"string","title":"Title"},"message":{"type":"string","title":"Message"}},"type":"object","required":["title","message"],"title":"CustomerAttribution","description":"Customer-facing attribution on a run: title + message, visible reasons only."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## GET /v1/status/attributions

> Customer-visible delay attributions overlapping the window

```json
{"openapi":"3.1.0","info":{"title":"Jua Query Engine API","version":"0.1.0"},"tags":[],"servers":[{"url":"https://query.jua.ai","description":"Production"}],"security":[{"HTTPBearer":[]}],"paths":{"/v1/status/attributions":{"get":{"tags":["status"],"summary":"Customer-visible delay attributions overlapping the window","operationId":"get_attributions_v1_status_attributions_get","parameters":[{"name":"subjects","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Subjects"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Window start, inclusive: the window is half-open `[since, before)`. Runs and attributions whose lifetime overlaps the window are returned. Defaults to 7 days before `before`; a window longer than 90 days is shortened to the 90 days ending at `before`.","title":"Since"},"description":"Window start, inclusive: the window is half-open `[since, before)`. Runs and attributions whose lifetime overlaps the window are returned. Defaults to 7 days before `before`; a window longer than 90 days is shortened to the 90 days ending at `before`."},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Window end, exclusive: the window is half-open `[since, before)`, so a run initialised exactly at `before` is not returned. Defaults to now.","title":"Before"},"description":"Window end, exclusive: the window is half-open `[since, before)`, so a run initialised exactly at `before` is not returned. Defaults to now."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttributionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AttributionsResponse":{"properties":{"attributions":{"items":{"$ref":"#/components/schemas/CustomerAttributionRecord"},"type":"array","title":"Attributions"}},"type":"object","title":"AttributionsResponse"},"CustomerAttributionRecord":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"message":{"type":"string","title":"Message"},"kind":{"type":"string","enum":["external","upstream","maintenance","internal"],"title":"Kind"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"subject_keys":{"items":{"type":"string"},"type":"array","title":"Subject Keys"}},"type":"object","required":["id","title","message","kind","starts_at","ends_at","subject_keys"],"title":"CustomerAttributionRecord","description":"Customer list row for ``GET /v1/status/attributions``."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## GET /v1/status/stats

> Per-subject run statistics for the caller's audience

```json
{"openapi":"3.1.0","info":{"title":"Jua Query Engine API","version":"0.1.0"},"tags":[],"servers":[{"url":"https://query.jua.ai","description":"Production"}],"security":[{"HTTPBearer":[]}],"paths":{"/v1/status/stats":{"get":{"tags":["status"],"summary":"Per-subject run statistics for the caller's audience","operationId":"get_stats_v1_status_stats_get","parameters":[{"name":"subjects","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Subjects"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"StatsResponse":{"properties":{"stats":{"items":{"$ref":"#/components/schemas/SubjectStats"},"type":"array","title":"Stats"}},"type":"object","title":"StatsResponse"},"SubjectStats":{"properties":{"subject_key":{"type":"string","title":"Subject Key"},"audience":{"type":"string","enum":["internal","early","standard"],"title":"Audience"},"overall":{"$ref":"#/components/schemas/RunGroupStats"},"by_init_clock":{"items":{"$ref":"#/components/schemas/InitClockStats"},"type":"array","title":"By Init Clock"},"daily":{"items":{"$ref":"#/components/schemas/DailyStats"},"type":"array","title":"Daily"}},"type":"object","required":["subject_key","audience","overall","by_init_clock","daily"],"title":"SubjectStats","description":"Per-subject statistics for one audience. Returned verbatim by query-engine."},"RunGroupStats":{"properties":{"count":{"type":"integer","title":"Count"},"complete_count":{"type":"integer","title":"Complete Count"},"on_time_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Time Pct"},"missing_count":{"type":"integer","title":"Missing Count"},"completion_delay":{"$ref":"#/components/schemas/DelayQuantiles"},"start_delay":{"anyOf":[{"$ref":"#/components/schemas/StartDelayQuantiles"},{"type":"null"}]},"on_time_pct_excluding_attributed":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Time Pct Excluding Attributed"},"attributed_count":{"type":"integer","title":"Attributed Count","default":0},"projected_late_count":{"type":"integer","title":"Projected Late Count","default":0},"projected_late_precision":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Projected Late Precision"}},"type":"object","required":["count","complete_count","on_time_pct","missing_count","completion_delay","start_delay"],"title":"RunGroupStats"},"DelayQuantiles":{"properties":{"p50":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P50"},"p90":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P90"},"p99":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P99"}},"type":"object","required":["p50","p90","p99"],"title":"DelayQuantiles","description":"Completion-delay quantiles in minutes over completed runs (``None`` when empty)."},"StartDelayQuantiles":{"properties":{"p50":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P50"},"p90":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P90"}},"type":"object","required":["p50","p90"],"title":"StartDelayQuantiles","description":"Start-delay quantiles in minutes; internal audience and weather only."},"InitClockStats":{"properties":{"count":{"type":"integer","title":"Count"},"complete_count":{"type":"integer","title":"Complete Count"},"on_time_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Time Pct"},"missing_count":{"type":"integer","title":"Missing Count"},"completion_delay":{"$ref":"#/components/schemas/DelayQuantiles"},"start_delay":{"anyOf":[{"$ref":"#/components/schemas/StartDelayQuantiles"},{"type":"null"}]},"on_time_pct_excluding_attributed":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Time Pct Excluding Attributed"},"attributed_count":{"type":"integer","title":"Attributed Count","default":0},"projected_late_count":{"type":"integer","title":"Projected Late Count","default":0},"projected_late_precision":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Projected Late Precision"},"init_clock":{"type":"string","title":"Init Clock"}},"type":"object","required":["count","complete_count","on_time_pct","missing_count","completion_delay","start_delay","init_clock"],"title":"InitClockStats"},"DailyStats":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"count":{"type":"integer","title":"Count"},"on_time_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Time Pct"},"p50":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P50"},"p90":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P90"},"late_count":{"type":"integer","title":"Late Count"},"delayed_count":{"type":"integer","title":"Delayed Count"},"attributed_count":{"type":"integer","title":"Attributed Count","default":0}},"type":"object","required":["date","count","on_time_pct","p50","p90","late_count","delayed_count"],"title":"DailyStats"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.jua.ai/api-v2/query-engine/open-api-reference/status.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
