Endpoints
API Endpoints
Complete reference for all Verity API endpoints
The Verity API provides endpoints for searching policies, looking up codes, checking prior authorization requirements, and more.
https://api.verity.health/v1
| Method | Endpoint | Description |
|---|
| GET | /health | Health check (no auth required) - returns API status, version, and component health |
Public endpoint for monitoring API health. No authentication required.
{
"success": true,
"data": {
"status": "healthy",
"version": "v1",
"checks": {
"database": { "status": "healthy", "latency_ms": 5 },
"redis": { "status": "healthy" },
"redis_cache": { "status": "healthy" }
},
"timestamp": "2024-12-17T10:30:00.000Z"
}
}
| Field | Description |
|---|
status | Overall API status: healthy, degraded, or unhealthy |
version | API version |
checks | Individual component health checks |
checks.database | PostgreSQL database connectivity and latency |
checks.redis | Redis rate limiter status |
checks.redis_cache | Redis cache status |
timestamp | ISO8601 timestamp of the health check |
| Status | HTTP Code | Description |
|---|
healthy | 200 | All systems operational |
degraded | 200 | Core functionality works, some features may be limited |
unhealthy | 503 | Critical systems are down |
| Method | Endpoint | Description |
|---|
| GET | /codes/lookup | Look up coverage for a procedure code |
| Method | Endpoint | Description |
|---|
| GET | /policies | Search Medicare coverage policies |
| GET | /policies/:id | Get a specific policy by ID |
| POST | /policies/compare | Compare coverage across jurisdictions |
| GET | /policies/changes | Get policy change feed |
| Method | Endpoint | Description |
|---|
| GET | /coverage/criteria | Search coverage criteria |
| Method | Endpoint | Description |
|---|
| POST | /prior-auth/check | Check if prior auth is required |
| Method | Endpoint | Description |
|---|
| GET | /jurisdictions | List MAC jurisdictions |