Integration

API Reference

REST API for EasyWarrant — warrant management, sessions, documents, and audit export.

API Access

API access is available to agency integrations only. All API requests must be authenticated with an agency-scoped token issued after CJIS Security Addendum execution. Contact your EasyWarrant agency representative to request API credentials.

Base URL

https://api.easywarrant.com/v1

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer <agency_api_token>

Tokens are scoped to a single agency and expire after 12 hours. Refresh tokens are issued via the /auth/token endpoint. All token operations are logged in the audit trail.

Endpoints

Warrants

Method	Endpoint	Description
`GET`	`/warrants`	List all warrant requests for the agency
`POST`	`/warrants`	Create a new warrant request
`GET`	`/warrants/:id`	Get a specific warrant by ID
`PATCH`	`/warrants/:id`	Update warrant status or metadata
`DELETE`	`/warrants/:id`	Void a warrant request (officer only)
`GET`	`/warrants/:id/document`	Download the sealed warrant document

Sessions

Method	Endpoint	Description
`POST`	`/sessions`	Initiate a new video session for a warrant
`GET`	`/sessions/:id`	Get session status and metadata
`POST`	`/sessions/:id/end`	Terminate an active session

Audit

Method	Endpoint	Description
`GET`	`/audit`	List audit log entries (paginated)
`GET`	`/audit/export`	Export full audit log with chain verification certificate

Rate Limiting

API requests are rate-limited per agency token. Limits are configurable and displayed in response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1711296000

Error Responses

{
  "error": {
    "code": "WARRANT_NOT_FOUND",
    "message": "Warrant wrnt_2026-0847 does not exist or is not accessible.",
    "requestId": "req_01J8XK2M4N5P6Q7R"
  }
}