API Reference
Complete API documentation for all 18 Legal endpoints (14 contract management + 4 strategic intelligence) with parameters and response examples.
Authentication
All API requests require authentication using your API key in the Authorization header:
Authorization: Bearer bp_legal_live_your_api_key_here
Base URL
https://api.brainpredict.ai/v1/legal
Endpoints
/api/v1/legal/contractsCreate a new contract with metadata and content
Endpoints
Parameters:
titlecontract_typepartieseffective_dateexpiration_datecontentExample Response:
{
"success": true,
"contract_id": "contract_123",
"status": "draft",
"created_at": "2025-10-31T10:00:00Z"
}/api/v1/legal/contractsList all contracts with filtering and pagination
Endpoints
Parameters:
skiplimitcontract_typestatusparty_nameExample Response:
{
"total": 150,
"contracts": [
{
"id": "contract_123",
"title": "Service Agreement",
"type": "service",
"status": "active"
}
]
}/api/v1/legal/contracts/{contract_id}Get detailed information about a specific contract
Endpoints
Parameters:
contract_idExample Response:
{
"id": "contract_123",
"title": "Service Agreement",
"parties": [
"Company A",
"Company B"
],
"effective_date": "2025-01-01",
"expiration_date": "2026-01-01",
"status": "active"
}/api/v1/legal/contracts/{contract_id}Update contract details and metadata
Endpoints
Parameters:
contract_idtitlestatuspartiescontentExample Response:
{
"success": true,
"contract_id": "contract_123",
"updated_at": "2025-10-31T11:00:00Z"
}/api/v1/legal/contracts/{contract_id}Delete a contract (soft delete)
Endpoints
Parameters:
contract_idExample Response:
{
"success": true,
"message": "Contract deleted successfully"
}/api/v1/legal/contracts/stats/summaryGet contract statistics and summary metrics
Endpoints
Parameters:
Example Response:
{
"total_contracts": 150,
"active": 120,
"expired": 20,
"expiring_soon": 10,
"total_value": 5000000,
"avg_duration_days": 365
}/api/v1/legal/contracts/{contract_id}/analyzeAnalyze contract using ContractAnalyzer AI (94.5% accuracy)
Endpoints
Parameters:
contract_idExample Response:
{
"risk_score": 0.35,
"key_clauses": [
"termination",
"liability",
"confidentiality"
],
"missing_clauses": [
"force_majeure"
],
"recommendations": [
"Add force majeure clause"
]
}/api/v1/legal/contracts/{contract_id}/assess-riskAssess contract risk using ContractRiskAssessor AI (92.8% accuracy)
Endpoints
Parameters:
contract_idExample Response:
{
"overall_risk": "medium",
"risk_score": 0.45,
"risk_factors": [
{
"factor": "termination_clause",
"severity": "medium",
"impact": 0.3
}
],
"mitigation_strategies": [
"Negotiate better terms"
]
}/api/v1/legal/contracts/{contract_id}/obligationsExtract contract obligations using ObligationExtractor AI (91.2% accuracy)
Endpoints
Parameters:
contract_idExample Response:
{
"obligations": [
{
"id": 1,
"description": "Monthly payment of $10,000",
"party": "Company A",
"due_date": "2025-11-01",
"status": "pending"
}
]
}/api/v1/legal/contracts/expiring/soonGet contracts expiring within specified days
Endpoints
Parameters:
daysExample Response:
{
"total": 10,
"contracts": [
{
"id": "contract_123",
"title": "Service Agreement",
"expiration_date": "2025-11-15",
"days_until_expiration": 15
}
]
}/api/v1/legal/contracts/high-risk/listGet list of high-risk contracts
Endpoints
Parameters:
Example Response:
{
"total": 5,
"contracts": [
{
"id": "contract_456",
"title": "Vendor Agreement",
"risk_score": 0.85,
"risk_level": "high"
}
]
}/api/v1/legal/contracts/{contract_id}/extract-clausesExtract and classify contract clauses using ClauseExtractor AI (93.7% accuracy)
Endpoints
Parameters:
contract_idExample Response:
{
"clauses": [
{
"type": "termination",
"text": "Either party may terminate...",
"risk_level": "medium",
"page": 5
}
]
}/api/v1/legal/contracts/{contract_id}/negotiateAnalyze negotiation position using NegotiationAdvisor AI (89.5% accuracy)
Endpoints
Parameters:
contract_idExample Response:
{
"negotiation_strength": "moderate",
"leverage_points": [
"Market position",
"Alternative vendors"
],
"recommended_terms": [
"Better payment terms",
"Extended warranty"
]
}/api/v1/legal/contracts/{contract_id}/lifecycle-stagePredict contract lifecycle stage using ContractLifecyclePredictor AI (90.8% accuracy)
Endpoints
Parameters:
contract_idExample Response:
{
"current_stage": "execution",
"predicted_next_stage": "renewal",
"days_to_next_stage": 45,
"confidence": 0.91
}/api/v1/legal/strategic/benchmarking/performanceBenchmark legal performance against industry standards
Endpoints
Parameters:
metricsindustrycompany_sizeExample Response:
{
"overall_score": 7.8,
"industry_average": 7.2,
"strengths": [
"Contract turnaround time"
],
"weaknesses": [
"Litigation costs"
],
"recommendations": [
"Implement contract automation"
]
}/api/v1/legal/strategic/contract-intelligence/aggregateAggregate contract intelligence across portfolio
Endpoints
Parameters:
contract_idsanalysis_typeExample Response:
{
"total_contracts": 150,
"total_value": 5000000,
"risk_distribution": {
"low": 100,
"medium": 40,
"high": 10
},
"key_insights": [
"High concentration in vendor contracts"
]
}/api/v1/legal/strategic/benchmarking/industry-standardsGet industry-specific legal benchmarking standards
Endpoints
Parameters:
industryExample Response:
{
"industry": "technology",
"avg_contract_value": 50000,
"avg_litigation_rate": 0.05,
"avg_compliance_score": 8.5,
"data_sources": [
"Industry reports",
"Legal databases"
]
}/api/v1/legal/strategic/contract-intelligence/portfolio-summaryGet comprehensive portfolio summary with strategic insights
Endpoints
Parameters:
Example Response:
{
"total_contracts": 150,
"active_value": 4500000,
"expiring_value": 500000,
"risk_exposure": "medium",
"strategic_recommendations": [
"Renegotiate high-risk contracts",
"Consolidate vendors"
]
}Rate Limits
API rate limits vary by plan:
- Starter: 1,000 requests/hour
- Professional: 10,000 requests/hour
- Enterprise: Unlimited
Error Codes
| Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid API key |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal Server Error |
SDKs & Libraries
We provide official SDKs for popular programming languages:
Python
pip install brainpredict-legalNode.js
npm install @brainpredict/legalJava
mvn install brainpredict-legalPHP
composer require brainpredict/legal