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