Skip to main content

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

POST/api/v1/legal/contracts

Create a new contract with metadata and content

Endpoints

Parameters:

titlecontract_typepartieseffective_dateexpiration_datecontent

Example Response:

{
  "success": true,
  "contract_id": "contract_123",
  "status": "draft",
  "created_at": "2025-10-31T10:00:00Z"
}
GET/api/v1/legal/contracts

List all contracts with filtering and pagination

Endpoints

Parameters:

skiplimitcontract_typestatusparty_name

Example Response:

{
  "total": 150,
  "contracts": [
    {
      "id": "contract_123",
      "title": "Service Agreement",
      "type": "service",
      "status": "active"
    }
  ]
}
GET/api/v1/legal/contracts/{contract_id}

Get detailed information about a specific contract

Endpoints

Parameters:

contract_id

Example Response:

{
  "id": "contract_123",
  "title": "Service Agreement",
  "parties": [
    "Company A",
    "Company B"
  ],
  "effective_date": "2025-01-01",
  "expiration_date": "2026-01-01",
  "status": "active"
}
PUT/api/v1/legal/contracts/{contract_id}

Update contract details and metadata

Endpoints

Parameters:

contract_idtitlestatuspartiescontent

Example Response:

{
  "success": true,
  "contract_id": "contract_123",
  "updated_at": "2025-10-31T11:00:00Z"
}
DELETE/api/v1/legal/contracts/{contract_id}

Delete a contract (soft delete)

Endpoints

Parameters:

contract_id

Example Response:

{
  "success": true,
  "message": "Contract deleted successfully"
}
GET/api/v1/legal/contracts/stats/summary

Get 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
}
POST/api/v1/legal/contracts/{contract_id}/analyze

Analyze contract using ContractAnalyzer AI (94.5% accuracy)

Endpoints

Parameters:

contract_id

Example Response:

{
  "risk_score": 0.35,
  "key_clauses": [
    "termination",
    "liability",
    "confidentiality"
  ],
  "missing_clauses": [
    "force_majeure"
  ],
  "recommendations": [
    "Add force majeure clause"
  ]
}
POST/api/v1/legal/contracts/{contract_id}/assess-risk

Assess contract risk using ContractRiskAssessor AI (92.8% accuracy)

Endpoints

Parameters:

contract_id

Example Response:

{
  "overall_risk": "medium",
  "risk_score": 0.45,
  "risk_factors": [
    {
      "factor": "termination_clause",
      "severity": "medium",
      "impact": 0.3
    }
  ],
  "mitigation_strategies": [
    "Negotiate better terms"
  ]
}
GET/api/v1/legal/contracts/{contract_id}/obligations

Extract contract obligations using ObligationExtractor AI (91.2% accuracy)

Endpoints

Parameters:

contract_id

Example Response:

{
  "obligations": [
    {
      "id": 1,
      "description": "Monthly payment of $10,000",
      "party": "Company A",
      "due_date": "2025-11-01",
      "status": "pending"
    }
  ]
}
GET/api/v1/legal/contracts/expiring/soon

Get contracts expiring within specified days

Endpoints

Parameters:

days

Example Response:

{
  "total": 10,
  "contracts": [
    {
      "id": "contract_123",
      "title": "Service Agreement",
      "expiration_date": "2025-11-15",
      "days_until_expiration": 15
    }
  ]
}
GET/api/v1/legal/contracts/high-risk/list

Get 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"
    }
  ]
}
POST/api/v1/legal/contracts/{contract_id}/extract-clauses

Extract and classify contract clauses using ClauseExtractor AI (93.7% accuracy)

Endpoints

Parameters:

contract_id

Example Response:

{
  "clauses": [
    {
      "type": "termination",
      "text": "Either party may terminate...",
      "risk_level": "medium",
      "page": 5
    }
  ]
}
POST/api/v1/legal/contracts/{contract_id}/negotiate

Analyze negotiation position using NegotiationAdvisor AI (89.5% accuracy)

Endpoints

Parameters:

contract_id

Example Response:

{
  "negotiation_strength": "moderate",
  "leverage_points": [
    "Market position",
    "Alternative vendors"
  ],
  "recommended_terms": [
    "Better payment terms",
    "Extended warranty"
  ]
}
POST/api/v1/legal/contracts/{contract_id}/lifecycle-stage

Predict contract lifecycle stage using ContractLifecyclePredictor AI (90.8% accuracy)

Endpoints

Parameters:

contract_id

Example Response:

{
  "current_stage": "execution",
  "predicted_next_stage": "renewal",
  "days_to_next_stage": 45,
  "confidence": 0.91
}
POST/api/v1/legal/strategic/benchmarking/performance

Benchmark legal performance against industry standards

Endpoints

Parameters:

metricsindustrycompany_size

Example Response:

{
  "overall_score": 7.8,
  "industry_average": 7.2,
  "strengths": [
    "Contract turnaround time"
  ],
  "weaknesses": [
    "Litigation costs"
  ],
  "recommendations": [
    "Implement contract automation"
  ]
}
POST/api/v1/legal/strategic/contract-intelligence/aggregate

Aggregate contract intelligence across portfolio

Endpoints

Parameters:

contract_idsanalysis_type

Example Response:

{
  "total_contracts": 150,
  "total_value": 5000000,
  "risk_distribution": {
    "low": 100,
    "medium": 40,
    "high": 10
  },
  "key_insights": [
    "High concentration in vendor contracts"
  ]
}
GET/api/v1/legal/strategic/benchmarking/industry-standards

Get industry-specific legal benchmarking standards

Endpoints

Parameters:

industry

Example Response:

{
  "industry": "technology",
  "avg_contract_value": 50000,
  "avg_litigation_rate": 0.05,
  "avg_compliance_score": 8.5,
  "data_sources": [
    "Industry reports",
    "Legal databases"
  ]
}
GET/api/v1/legal/strategic/contract-intelligence/portfolio-summary

Get 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

CodeDescription
400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error

SDKs & Libraries

We provide official SDKs for popular programming languages:

Python

pip install brainpredict-legal

Node.js

npm install @brainpredict/legal

Java

mvn install brainpredict-legal

PHP

composer require brainpredict/legal