Grid Accord

Note 015

API

The only server in this build is a loopback development process. It is unauthenticated on purpose and must not be exposed. It does not store results. GET /v1/screens/<id> returns 404 with retrieval_unsupported.

Status order

  1. needs_input when the body or the mode cannot be read, or a synthetic request is ambiguous. HTTP 400.
  2. production_disabled when the mode is intended_production, or a release boolean claims rights, review, or billing. HTTP 200.
  3. source_under_review when the release is missing, revoked, expired, or not the demonstration id. HTTP 200.
  4. not_covered when no registered ruleset matches the utility, or the service intent is not retail large-load service. HTTP 200. A registered ruleset that is pending, appealed, or not yet effective returns source_under_review and does not apply the terms. The live list is state coverage.
  5. conditional_screen or completed_screen for a synthetic demonstration. HTTP 200. Neither certifies eligibility.
  6. system_error on an unexpected failure, a local rate limit (HTTP 429), or a local runtime budget (HTTP 503).

Local limits

Body size 16384 bytes. Ramp steps 24. Questions 8. Handler budget 2000 ms. Rate limit 30 POSTs per 10 seconds in one process. These are not distributed limits. GET /v1/limits repeats them.

The OpenAPI document and JSON schemas live in packages/contracts and are also copied to /openapi.json on this site for reading. That file is not a live production host.