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