CDE CAD Developer Documentation

Complete API reference for the CDE Computer Aided Dispatch platform.

Base URL: https://cdecad.com/api — All endpoints are prefixed with /api. Custom domains also supported (e.g. https://yourserver.cdecad.com/api).

Quick Links

Authentication

Discord OAuth, JWT tokens, API keys, and session management.

Civilian API

Characters, vehicles, licenses, 911 calls, banking, stolen vehicles, and missing persons.

Dispatch & LEO

Calls, units, lookups, BOLOs, suspects, unit tracking, and the dispatch board.

Reports & Judicial

Incident reports, citations, arrests, warrants, license suspensions, and court requests.

Community Admin

Community setup, departments, members, permissions, settings, and custom domains.

Users & Officers

Profiles, status codes, active units, Discord role sync, officer management, and report autofill.

Admin & Security

Security monitoring, login attempts, IP blocking, user bans, supervisor analytics, and health checks.

Search & Lookup

Smart search, civilian/vehicle lookup, home page config, changelogs, events, and FiveM server status.

FiveM Integration

Server registration, 911 calls, panic button, livemap, and in-game character sync.

WebSocket Events

Real-time events for calls, units, panic alerts, BOLOs, and announcements.

Authentication Overview

CDE CAD uses three authentication methods depending on the context:

MethodUsed ForHeader
JWT Bearer Token All authenticated user requests (dashboard, dispatch, admin) Authorization: Bearer <token>
FiveM API Key Server-to-CAD requests (911, panic, livemap, character sync) x-api-key: fvm_xxxxx
Session Cookie Browser-based sessions after Discord OAuth login Automatic (cookie-based)

Rate Limits

Route GroupLimitWindow
General API300 requests1 minute
Auth (login)10 attempts15 minutes
Lookups / Search60 requests1 minute
FiveM General120 requests1 minute (per API key)
FiveM High-Impact (911, panic)20 requests1 minute (per API key)
Report Generation60 requests1 minute (per user)

Response Format

All endpoints return JSON. Successful responses typically include the requested data directly. Error responses follow this format:

{
  "success": false,
  "msg": "Human-readable error description"
}

Common Status Codes

CodeMeaning
200Success
201Created (new resource)
400Bad request (missing or invalid fields)
401Unauthorized (missing or invalid auth)
403Forbidden (insufficient permissions)
404Not found
429Rate limit exceeded
500Internal server error

Multi-Community Architecture

CDE CAD is multi-tenant. Every resource (civilians, vehicles, calls, reports, etc.) is scoped to a community. Most endpoints require a communityId parameter to identify which community's data to access.

Communities map to Discord servers via their guildId. When a user authenticates via Discord OAuth, their guild memberships are synced and they gain access to the corresponding CAD communities.