API Reference
REST API
Complete reference for the Meridian REST API.
The Meridian REST API lets you ingest events, query cases, retrieve conformance scores, and manage your process models programmatically.
Base URL
text
https://api.meridian.io/v1Authentication
All API requests require a Bearer token. Pass your API key in the Authorization header.
bash
curl https://api.meridian.io/v1/cases \
-H "Authorization: Bearer mk_live_xxxxxxxxxxxx"Ingest an event
bash
POST /v1/events
{
"projectId": "proj_xxxx",
"caseId": "INV-2026-001",
"activity": "Invoice Created",
"timestamp": "2026-02-10T09:15:00Z",
"attributes": {
"amount": 15000,
"vendor": "Acme Corp"
}
}Query cases
bash
GET /v1/cases?projectId=proj_xxxx&status=deviated&limit=50