Developer API

Build on Not Your Lawyer

Integrate your tools with Not Your Lawyer using our REST API. Manage cases, contacts, documents, treatments, and tasks programmatically. Subscribe to real-time webhook events for instant notifications.

OpenAPI Spec Get API Keys

Plan requirement: API access is available on Professional and Enterprise plans — contact sales team for pricing. View plans

Authentication

All API requests require a Bearer token. Generate API keys in your dashboard under Settings > API Keys.

Authorization: Bearer <YOUR_API_TOKEN>

API keys are scoped to specific permissions and can be revoked at any time. The raw key is shown only once on creation — store it securely.

Rate Limits

Default rate limit is 60 requests per minute per API key. Custom limits up to 1,000/min are available on Enterprise plans. Every response includes rate limit headers: - X-RateLimit-Limit — Maximum requests per minute - X-RateLimit-Remaining — Requests remaining in the current window - X-RateLimit-Reset — Unix timestamp when the window resets When the limit is exceeded, the API returns 429 Too Many Requests.

Webhooks

Subscribe to real-time events instead of polling. Configure webhook subscriptions in Settings > API Keys > Webhooks. Each delivery includes an X-NYL-Signature header — an HMAC-SHA256 signature of the request body using your shared secret. Always verify this signature before processing events. Subscriptions are automatically deactivated after 10 consecutive delivery failures.

Scopes

API keys are scoped to specific permissions. Only request the scopes your integration needs.

Quick Start

# List your cases
curl -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  https://notyourlawyer.ai/api/cases

# Create a case
curl -X POST -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"clientName":"Jane Doe","clientPhone":"555-0100","accidentDate":"2026-01-15","accidentType":"MVA"}' \
  https://notyourlawyer.ai/api/cases

OpenAPI Specification

The full OpenAPI 3.1 specification is available at [/api/openapi.json](/api/openapi.json). Import it into Postman, Insomnia, or any OpenAPI-compatible tool to explore endpoints and generate client SDKs.

Available Scopes

cases:read

cases:write

contacts:read

contacts:write

documents:read

documents:write

treatments:read

treatments:write

tasks:read

tasks:write

court-events:read

intake:write

Webhook Events

case.created

case.updated

case.stage_changed

contact.created

contact.updated

document.uploaded

intake.received

task.created

task.completed

Endpoints

GET/api/casesList cases

POST/api/casesCreate a case

GET/api/cases/{id}Get case details

PATCH/api/cases/{id}Update a case

GET/api/contactsList contacts

POST/api/contactsCreate a contact

GET/api/contacts/{id}Get contact details

PATCH/api/contacts/{id}Update a contact

GET/api/cases/{id}/documentsList case documents

GET/api/cases/{id}/treatmentsList case treatments

POST/api/cases/{id}/treatmentsAdd a treatment

GET/api/tasksList tasks

POST/api/tasksCreate a task

GET/api/cases/{id}/court-eventsList court events

POST/api/intakeSubmit an intake

Need help integrating? Contact support

# List your cases curl -H "Authorization: Bearer <YOUR_API_TOKEN>" \ https://notyourlawyer.ai/api/cases # Create a case curl -X POST -H "Authorization: Bearer <YOUR_API_TOKEN>" \ -H "Content-Type: application/json" \ -d '{"clientName":"Jane Doe","clientPhone":"555-0100","accidentDate":"2026-01-15","accidentType":"MVA"}' \ https://notyourlawyer.ai/api/cases