SnapReport
SnapReport API
Send auditor evidence (notes, transcripts, audio, images, PDFs) against a standard and receive AI grading suggestions per clause. Stateless — nothing is persisted; your system owns the audit.
Endpoints
- POST /api/v1/snapreport/analyze — send evidence against a standard, get per-clause grading suggestions.
- GET /api/v1/snapreport/jobs/:jobId — poll the status of an async job.
- GET /api/v1/standards — list standards and clauses you can analyze against.
Permission required
snapreport:generate on the API key used. See Authentication.
What you submit
- A standard (ISO 9001, IFS Food, BRCGS, etc.) and, optionally, the chapters you want scoped.
- Evidence: any mix of text notes, transcripts, audio recordings, photos, and PDFs.
What you get back
- A suggestions array — one entry per clause the evidence supports, with grade, comment, and reasoning.
- Token usage and processing time for billing transparency.
No audit_id, no server-side state. You decide whether to apply suggestions to your own records, review them manually, or feed them into your own workflow.
Processing model
Analysis typically takes 30 seconds to 2 minutes depending on evidence volume and the number of clauses in scope. Pass a callback_url to switch to async mode and receive the result via webhook; otherwise the request blocks until analysis completes.