Developers & API

Build on
Akili Suite.

A RESTful JSON API with 60+ endpoints, webhook subscriptions, and up to 2,000 requests per minute. Connect your firm's tools, automate workflows, and push data to your BI stack.

API Reference Get API Access
GET /api/admin/matters 
// Fetch all active matters for the tenant
const response = await fetch(
  'https://yourfirm.akilisuite.com/api/admin/matters',
  {
    headers: {
      'Authorization': `Bearer ${JWT_TOKEN}`,
      'Content-Type': 'application/json'
    }
  }
);

const { matters, total } = await response.json();
// → { matters: [...], total: 42 }

// Each matter includes:
// id, title, centre, practice_area,
// milestone, progress, risk_level,
// success_probability, billing_rate
Rate Limits by Plan
Essentials
-
API not available
Intelligence
-
API not available
Command
600
requests / minute
Enterprise
2,000
requests / minute
API access requires Command plan or above
The Akili Suite API is available on Command (read + write) and Enterprise (full read/write + webhooks) plans. If you're on Intelligence and need API access for an integration project, contact us - we can discuss options.
Command - Read + Write API Enterprise - Full API + Webhooks
Endpoint Groups

60+ endpoints.
Every resource.

Matters 8
Full CRUD on legal matters - create, query, update, milestone tracking.
  • GET /api/admin/matters
  • POST /api/admin/matters
  • GET /api/admin/matters/:id
  • PATCH /api/admin/matters/:id
Clients 6
Client records, engagement scores, retainer balances.
  • GET /api/admin/clients
  • POST /api/admin/clients
  • PATCH /api/admin/clients/:id
  • GET /api/admin/clients/:id/retainer
Invoices 6
Invoice lifecycle, status transitions, currency handling.
  • GET /api/admin/invoices
  • POST /api/admin/invoices
  • PATCH /api/admin/invoices/:id
  • GET /api/admin/invoices/:id
Documents 7
Document management, R2 upload tokens, download tokens.
  • GET /api/admin/documents
  • POST /api/admin/documents
  • GET /api/admin/documents/:id/download
  • DEL /api/admin/documents/:id
Time Entries 5
Billable hour capture, rates, unbilled value queries.
  • GET /api/admin/time-entries
  • POST /api/admin/time-entries
  • PATCH /api/admin/time-entries/:id
  • DEL /api/admin/time-entries/:id
Analytics 4
Dashboard KPIs, reports, survey stats, activity log.
  • GET /api/admin/dashboard
  • GET /api/admin/surveys/stats
  • GET /api/admin/activity
  • GET /api/admin/surveys
Authentication

JWT bearer tokens.
No passwords.

Every API request requires a valid JWT in the Authorization: Bearer <token> header. Tokens are issued via the magic-link authentication flow and expire after 24 hours. Rotate tokens via the session management endpoint or the admin portal.

Token structure (decoded JWT payload) 
{
  "sub": "user-uuid",
  "email": "[email protected]",
  "role": "admin",          // admin | advocate | client
  "tenant_id": "tenant-uuid",
  "jti": "unique-token-id", // for revocation
  "iat": 1711670400,
  "exp": 1711756800      // 24-hour expiry
}
Webhooks Enterprise only

Real-time event subscriptions.

Subscribe to platform events and receive HTTP POST payloads to your endpoint. HMAC-SHA256 signed. Retry with exponential backoff on failure. Available on Enterprise plans.

matter.created
New matter opened
invoice.paid
Payment confirmed
client.created
New client record
document.uploaded
File added to matter
survey.submitted
Client satisfaction response
invoice.overdue
Payment past due date

Ready to build?

Full API reference, example requests, and response schemas are in the developer documentation. Command plan or above required to generate API credentials.

Read the Docs Enterprise Plan