API reference · Population & programmes

Unit readiness

Built — gated1 endpoint · OpenAPI tag readiness

For military units and first-responder organisations only: readiness as counts (physiology off members' own baselines, training-load bands, duty status) over the members who share biometrics with the unit. Nothing below the minimum cell, small cells and dominant states withheld, no questionnaire or behavioural-health field (enforced in code), no individual. Never a projection: projection.available is always false. A conversation starter, not a duty-status or deployability determination; Norvya is not a DoD system of record.

Who calls it: Core for Federal (via primes)
Before production: No gate of its own; your market's “Before production” applies.
Sandbox: Build against synthetic members first. What each sandbox holds

Markets that use this family

Federal (via primes) (core)

Scopes

Scope	Allows
`programs.readiness.read`	Read unit readiness as counts only (physiology, training load, duty status), small cells and dominance suppressed, no individual, no questionnaire or behavioural-health data and never a projection (military unit and first-responder organisations only).

Endpoints

Unit readiness as counts only (military units and first responders); never a projection

GET/v1/population/readinessprograms.readiness.read

readiness_unit's COMMAND tier: physiology, training-load and duty status distributions over members who share biometrics with the unit; nothing at all below agg_min_cell members, small cells and dominance withheld, no questionnaire or behavioural-health field (asserted in code), no individual. `projection.available` is always false: Norvya holds no military parameter set and refuses to project. A conversation starter, not a duty-status or deployability determination. 409 not_a_unit for any other organisation.

Parameters

as_ofquery · string | null

YYYY-MM-DD (default today).

All responses

200Successful Response401Unauthorized403Forbidden404Not Found409Conflict422Unprocessable Entity429Too Many Requests503Service Unavailable

Codes every call can return are in Errors & limits.

curl -s "https://norvya.fly.dev/v1/population/readiness" \
  -H "Authorization: Bearer $TOKEN"

import os

import requests

BASE = "https://norvya.fly.dev"
TOKEN = os.environ["TOKEN"]

resp = requests.get(
    BASE + "/v1/population/readiness",
    headers={"Authorization": f"Bearer {TOKEN}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ (ES module). Keep production credentials on your server.

const BASE = "https://norvya.fly.dev";
const url = new URL(`${BASE}/v1/population/readiness`);

const res = await fetch(url, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log(await res.json());

Generated from the Partner API router and developers_catalog.py. The router docstring is the source of each description.