API Reference
This section provides detailed technical information about the Verdict APIs.
Available APIs
| Route | Description | Version | 
|---|---|---|
| /api/v1/screen | Screen lead intake against your configured practice areas and threshold score | v1 | 
| /api/v1/score | Get detailed quality score and analysis for client intake data | v1 | 
API Versioning
All APIs are versioned to ensure backward compatibility:
- The current stable version is v1
- The base URL for all endpoints is https://www.caseverdict.com/api/{version}/
- We will maintain backward compatibility for the life of a major version
When breaking changes are introduced, we will:
- Release a new major version
- Provide migration guides
- Support the previous version for at least 6 months
Response Format
All API responses follow a consistent JSON format:
{
  "success": true,
  "results": {
    // API-specific response data
  },
  "timestamp": "2023-06-01T12:34:56.789Z"
}Error Format
Error responses will include:
{
  "error": "Human-readable error message",
  "details": {
    // Optional additional details about the error
  }
}Status Codes
| Status Code | Description | 
|---|---|
| 200 | Success | 
| 400 | Bad Request - Invalid input parameters | 
| 401 | Unauthorized - Missing or invalid API key | 
| 403 | Forbidden - Insufficient permissions | 
| 404 | Not Found - Resource doesn’t exist | 
| 429 | Too Many Requests - Rate limit exceeded | 
| 500 | Internal Server Error | 
Last updated on