Public API and contract downloads

Use the GET endpoints below at this service’s HTTPS address to read available information.

Unknown or duplicate query parameters are rejected. Page limits are 1–50 (default 50); use next_cursor with unchanged filters. Issue API search allows 256 characters / 1024 UTF-8 bytes; web search uses 200 / 800. A successful or empty response does not establish project safety, complete collection or feed publication.

Accepted parameters and bounds

• GET /api/v1/public/capabilities

  —

• GET /api/v1/public/issues

  q; confirmation=candidate; source_state=active|corrected|withdrawn|conflicting; modified_after=RFC3339; limit=1…50; cursor

• GET /api/v1/public/issues/{id}

  revision ≥ 1

• GET /api/v1/public/issues/{id}/investigation-prompt

  revision ≥ 1 (required) → JSON

• GET /api/v1/public/issues/{id}/investigation-prompt.txt

  revision ≥ 1 (required) → text/plain; charset=utf-8

• GET /api/v1/public/status

  —

• GET /api/v1/public/status/collection

  limit=1…50; cursor

• GET /api/v1/public/status/notices

  component=query|feed|collection; locale=en|ko|ja|zh-Hans|es|fr|ru|pt-PT; limit=1…50; cursor

• GET /api/v1/public/status/notices/{id}

  revision ≥ 1

• GET /api/v1/public/vendor-news

  q ≤ 200 characters / 800 UTF-8 bytes; vendor=gitlab|railway|vercel|supabase; kind=incident|patch|advisory|outage; deployment=saas|self_hosted|mixed|unknown; product_id; origin_locale=en|ko|ja|zh-Hans|es|fr|ru|pt-PT|und; limit=1…50; cursor

• GET /api/v1/public/vendor-news/{id}

  revision ≥ 1

• GET /api/v1/public/contracts/{version}

  version=current|1.0.0|1.1.0|1.2.0|1.3.0

• GET /api/v1/public/contracts/{version}/{artifact}

  version=current|1.0.0|1.1.0|1.2.0|1.3.0; artifact: public-contracts.openapi.json, issue-page.schema.json, feed-manifest.schema.json, feed-record.schema.json, feed-record-v1.1.schema.json, feed-record-v1.2.schema.json, feed-recovery.schema.json

Request examples (relative to this HTTPS service)

• GET /api/v1/public/capabilities
• GET /api/v1/public/issues?limit=10
• GET /api/v1/public/status
• GET /api/v1/public/vendor-news?vendor=gitlab&limit=10

Errors and recovery

404: unavailable, unsupported or no longer public; return to current information. 422: fix parameters. 409: cursor scope changed; restart the query. 410: cursor expired; restart. 429: wait for Retry-After. 503: retry later. Errors include error.code and request_id when provided; retain them when requesting help. These reads never start a model or remediation.