/api/v1/score

This endpoint allows you to analyze legal client intake data and receive a detailed quality score with analysis notes.

Introduction

This endpoint evaluates potential client information and returns a numerical quality score and analysis notes. This helps you quickly understand the strength of a legal case based on the provided information.

Key features:

Detailed quality scoring from 0-100
Comprehensive case analysis
Objective evaluation of case merits
Analysis notes with key insights

Authentication

All API requests require authentication using a Bearer token in the Authorization header:


Authorization: Bearer YOUR_API_KEY

Quickstart

Here’s how to quickly start using this endpoint:

Ensure you have an active PRO subscription
Make a POST request to the endpoint with your client intake data
Receive a detailed analysis with score and notes

Endpoint: POST /api/v1/score

Analyzes a single client intake record and returns a quality score and detailed analysis.

Request


POST https://www.caseverdict.com/api/v1/score
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
 
{
  "record": {
    "firstName": "John",
    "lastName": "Doe",
    "phone": "555-123-4567",
    "email": "john.doe@example.com",
    "location": "New York City",
    "zip": "10001",
    "county": "New York",
    "state": "NY",
    "practiceArea": "Personal Injury",
    "intakeNotes": "Client suffered a slip and fall injury at a grocery store. Possible broken wrist and hip injury."
  }
}

Request Parameters

Parameter	Type	Required	Description
firstName	string	Yes	Client’s first name
lastName	string	Yes	Client’s last name
phone	string	Yes	Client’s phone number
email	string	Yes	Client’s email address
location	string	Yes	Client’s city/location
zip	string	Yes	Client’s ZIP code
county	string	Yes	Client’s county
state	string	Yes	Client’s state
practiceArea	string	Yes	Practice area for the case
intakeNotes	string	Yes	Notes from the client intake

Response


{
  "success": true,
  "results": {
    "analysisScore": 85,
    "analysisNotes": "Strong personal injury case with clear liability and documented injuries. Medical records will be essential. Claim filed within statute of limitations."
  },
  "timestamp": "2023-04-05T12:34:56.789Z"
}

Response Fields

Field	Type	Description
success	boolean	Indicates if the API request was successful
results.analysisScore	number	A score from 0-100 indicating case quality (higher is better)
results.analysisNotes	string	Short analysis notes explaining the score (max 300 characters)
timestamp	string	ISO timestamp of when the analysis was performed

Scoring Criteria

The analysis score (0-100) is based on the following factors:

Intake Notes Analysis (80 points)
- Legal Issue Clarity (20 points)
- Case Strength (20 points)
- Damages Assessment (20 points)
- Legal Merit (20 points)
Information Completeness (20 points)
- Required Fields Present (10 points)
- Data Quality (10 points)

Score Interpretation

0-30: Poor quality (insufficient intake details, unclear legal issues)
31-60: Moderate quality (basic case details but lacking specifics)
61-85: Good quality (clear legal issues with supporting details)
86-100: Excellent quality (comprehensive case details with strong merit)

Error Responses

400 Bad Request


{
  "error": "Record must match the InputRecord type",
  "details": [/* Validation error details */]
}

401 Unauthorized


{
  "error": "Invalid or missing API key"
}


{
  "error": "User does not have an active subscription"
}


{
  "error": "User's plan does not have access to the API"
}

500 Internal Server Error


{
  "error": "Failed to analyze record"
}

How It Works

The API validates your subscription status and API key
It checks that the record contains all required fields
It uses advanced AI analysis to evaluate the intake notes and case details
The system assigns a quality score based on:
- Clarity of the legal issue
- Strength of the case (evidence, witnesses)
- Assessment of damages
- Legal merit and viability
- Completeness of provided information
The analysis notes highlight key strengths, weaknesses, and missing information

Best Practices

Provide detailed intake notes for the most accurate scoring
Include specific details about incidents, injuries, and damages
Mention available evidence and documentation
Note any relevant dates or timelines
Ensure all contact information is accurate and complete