{"openapi":"3.0.3","info":{"title":"Veritas 360 Public Compliance API","version":"1.0.0","description":"Framework discovery and compliance document generation for any jurisdiction. Authenticate every request with your API key. New keys start in sandbox mode (deterministic sample responses, no AI spend); your account manager switches the key to live when you are ready."},"servers":[{"url":"/api/public/v1"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Authorization: Bearer v360_sk_..."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"},"requestId":{"type":"string"}}}}}}},"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/ping":{"get":{"summary":"Connectivity + key check","responses":{"200":{"description":"ok — includes your key mode (sandbox|live)"}}}},"/capabilities":{"get":{"summary":"Document types, formats and your limits","responses":{"200":{"description":"ok"}}}},"/frameworks/suggest":{"post":{"summary":"Discover compliance frameworks for a query or jurisdiction","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","example":"UAE"},"jurisdiction":{"type":"string","example":"Dubai"},"domain":{"type":"string"},"regulator":{"type":"string"},"description":{"type":"string"}}},"example":{"query":"UAE frameworks","jurisdiction":"United Arab Emirates"}}}},"responses":{"200":{"description":"{ mode, candidates[], warnings[]? }"},"400":{"description":"missing_query"},"429":{"description":"rate_limited"}}}},"/documents/generate":{"post":{"summary":"Queue a compliance document generation job (202 + poll)","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["framework"],"properties":{"framework":{"type":"string","example":"Dubai ISR"},"type":{"type":"string","example":"framework_reference"},"jurisdiction":{"type":"string","example":"United Arab Emirates"},"company":{"type":"string"},"sector":{"type":"string"},"context":{"type":"string"},"humanize":{"type":"boolean","default":false}}}}}},"responses":{"202":{"description":"{ jobId, status, poll, document, estimatedSeconds }"},"400":{"description":"missing_framework / unknown_document_type"},"409":{"description":"job_already_running"},"429":{"description":"daily/monthly quota exceeded"}}}},"/jobs/{jobId}":{"get":{"summary":"Poll a generation job","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"{ status: queued|running|completed|failed }"},"404":{"description":"job_not_found"}}}},"/documents/{jobId}":{"get":{"summary":"Fetch a completed document","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","md","pdf","docx"],"default":"json"}}],"responses":{"200":{"description":"Document in the requested format"},"409":{"description":"not_ready / generation_failed"}}}},"/usage":{"get":{"summary":"Your usage against quotas","responses":{"200":{"description":"ok"}}}}}}