Back to developer guide

Developer examples

Server-side implementation examples

Use these examples as safe implementation patterns for disclosure generation, evidence capture, and verification lookups.

Classify a disclosure

Submit the AI use case and receive structured data for the disclosure workflow.

curl -X POST https://review.getsunura.com/api/v1/disclosures/classify \
  -H "x-sunura-api-key: $SUNURA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"AI assistant","description":"Customer service chatbot","aiSystemType":"chatbot","jurisdiction":"EU"}'

Generate a notice

Generate disclosure copy for a specific customer-facing surface.

const response = await fetch("https://review.getsunura.com/api/v1/disclosures/generate", {
  method: "POST",
  headers: {
    "x-sunura-api-key": process.env.SUNURA_API_KEY ?? "",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    disclosureId: "disc_123",
    surface: "customer-website"
  })
});

Capture an evidence event

Record that a disclosure was displayed, including version and runtime context.

curl -X POST https://review.getsunura.com/api/v1/evidence/capture \
  -H "x-sunura-api-key: $SUNURA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"disclosureId":"disc_123","surface":"customer-website","eventType":"notice_rendered"}'