Getting started
Build on the Auditmark API to read and write your organization's data.
The Auditmark API lets external systems read and write your organization's data. All integration work targets the service API, versioned at /v1. Its base URL is https://api.auditmark.io/v1.
Authentication
Every request to /v1 requires an organization API key sent as a bearer token in the Authorization header. You create and revoke keys in the admin app, not through the API. See Authentication and API keys for how to create a key and attach it to requests.
What the API exposes
The service API covers your organization's shared resources. Each group below maps to one or more endpoint families in the reference.
| Resource group | What it covers |
|---|---|
| Templates | Templates, template families, draft and publish flow, family tags |
| Inspections | Inspection lifecycle, responses, sections, participants, start and advance |
| Findings and corrective actions | Findings on an inspection and the corrective actions raised from them |
| Approvals and sign-offs | Inspection approvals and sign-off records |
| Reports | Generated reports, report preview, and report email |
| Report layouts | Report layout definitions, presets, covers, logos, and defaults |
| Report themes | Report theme definitions, fonts, and previews |
| Attachments | Inspection attachments and signed attachment URLs |
| Client accounts | Client account records |
| Locations | Location records |
| Response sets | Manual and sourced response sets and their options |
| Schedules | Inspection schedules, calendar, previews, and overrides |
| Tags | Org tags |
| Documents | The document library |
| Notices | Notices, inbox, acknowledgments, and recipients |
| Members | Org members, assignable members, and your own profile and preferences |
| Organization | Org settings and logo |
| Integrations | Integration connections, sources, sync runs, directory sources, and user candidates |
| Analytics | Dashboards, widgets, KPI definitions, and query endpoints |
| Issues | Issue categories, public links, and issues |
The interactive API reference in these docs lists every endpoint and lets you try calls directly. The OpenAPI description is published at https://api.auditmark.io/v1/openapi.json if you want to generate a client or import it into a tool like Postman.
What stays in the admin app
Some capabilities are deliberately outside the API key surface and are managed only in the admin app at app.auditmark.io:
| Capability | Where it lives |
|---|---|
| API key creation and revocation | Settings, on the API keys tab |
| Webhook endpoint management | Settings |
| AI features | Throughout the admin app |
An organization API key cannot create or revoke keys, manage webhook endpoints, or drive an AI call. AI features require a signed-in admin.
Where to go next
| Page | What you do there |
|---|---|
| Authentication and API keys | Create a key and make your first request. |
| Webhooks | Receive Auditmark events at your own endpoint. |
| Errors and rate limits | Understand error shapes and request limits. |