Auto Approval Evaluator - API Contract

REST /api/v1/claims 1 endpoint

POST /api/v1/claims/api/v1/claims/:id/evaluate

Evaluate whether a claim qualifies for auto-approval based on org threshold and absence of additional expenses. Returns computed status without mutating the claim.

Public

Request Example

{
  "claim_id": "clm_01HXQR9B2T",
  "org_id": "org_xyz789"
}

Response Example

{
  "claim_id": "clm_01HXQR9B2T",
  "recommended_status": "auto_approved",
  "distance_km": 42.5,
  "threshold_km": 50,
  "below_threshold": true,
  "has_additional_expenses": false,
  "evaluated_at": "2026-03-25T14:30:01Z"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}