Audit Status

Retrieve the current status or full report for an audit.

GET https://audit-engine.oathe.ai/api/audit/{auditId}

Retrieve the current status or full report for an audit. The response shape changes based on the audit’s lifecycle stage.

Audit Statuses

queued
Waiting in the processing queue.
scanning
Preparing the audit environment.
analyzing
Evaluating skill behavior.
summarizing
Compiling results.
finalizing
Generating the report.
complete
Audit finished — full report available.
failed
Audit encountered an error.

Example

curl https://audit-engine.oathe.ai/api/audit/a1b2c3d4-e5f6-7890-abcd-ef1234567890

In-Progress Response

{
  "audit_id": "a1b2c3d4-...",
  "skill_url": "https://github.com/user/repo",
  "status": "analyzing",
  "stage_label": "Analyzing skill behavior."
}

Complete Response

{
  "audit_id": "a1b2c3d4-...",
  "skill_url": "https://github.com/user/repo",
  "status": "complete",
  "report": {
    "audit_id": "a1b2c3d4-...",
    "skill_url": "https://github.com/user/repo",
    "skill_slug": "user/repo",
    "timestamp": "2026-01-15T10:30:00.000Z",
    "trust_score": 85,
    "verdict": "SAFE",
    "summary": "No significant security concerns detected.",
    "recommendation": "INSTALL",
    "category_scores": {
      "prompt_injection": { "score": 100, "findings": [] },
      "data_exfiltration": { "score": 70, "findings": ["Direct data exfiltration via HTTP"] },
      "code_execution": { "score": 90, "findings": [] },
      "clone_behavior": { "score": 100, "findings": [] },
      "canary_integrity": { "score": 100, "findings": [] },
      "behavioral_reasoning": { "score": 80, "findings": [] }
    },
    "findings": [...]
  }
}
Each category_scores entry contains score (0–100) and findings (array of finding titles). See Findings for the full schema.

Caching

Completed audits are cached. In-progress audits are not — poll until status is complete or failed.