Skip to Content
Verdict is in beta 🎉
API ReferenceOverview

API Reference

This section provides detailed technical information about the Verdict APIs.

Available APIs

RouteDescriptionVersion
/api/v1/screenScreen lead intake against your configured practice areas and threshold scorev1
/api/v1/scoreGet detailed quality score and analysis for client intake datav1

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:

  1. Release a new major version
  2. Provide migration guides
  3. 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 CodeDescription
200Success
400Bad Request - Invalid input parameters
401Unauthorized - Missing or invalid API key
403Forbidden - Insufficient permissions
404Not Found - Resource doesn’t exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error
Last updated on