Back to developer guide

API reference

API reference for SUNURA integrations

Endpoint catalogue for authentication, disclosure workflows, evidence capture, exports, and verification references.

Authentication

Send the API key with x-sunura-api-key from a trusted server-side environment.

Disclosure routes

Use disclosure routes to classify AI use cases and generate approved notice content.

  • POST /api/v1/disclosures/classify
  • POST /api/v1/disclosures/generate

Evidence routes

Use evidence routes to record notice rendering, version, runtime context, and verification references.

  • POST /api/v1/evidence/capture
  • GET /api/v1/evidence/:id

Export routes

Use export routes to prepare PDF, JSON, CSV, or ZIP materials for review workflows.

  • POST /api/v1/exports
  • GET /api/v1/exports/:id

Error handling

Handle 400 responses as request validation issues, 401 responses as authentication failures, and 429 responses as rate-limit events.