API

Who this is for

The API is for developers connecting their own intake systems, case management tools, or custom workflows. Available on Firm and Enterprise plans.

If you're an attorney who just wants to screen cases, use the dashboard or Clio integration instead.

Creating API keys

Go to Dashboard → API Keys, click Create API Key.

Give it a descriptive name — "Filevine Production" or "Staging Environment" — and pick an expiration (or never).

After creation, you'll see the secret once. Copy it immediately. We don't store the plaintext — you won't see it again.

You can create multiple keys for different environments. Revoke any key instantly from the dashboard.

Your first request

curl -X POST \  "https://mdlmatch.ai/api/v1/match" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{"text": "Client diagnosed with ovarian cancer after lifetime exposure to talcum powder products manufactured by Johnson & Johnson..."}'

You get back ranked MDL matches with confidence scores, matched products and injuries, and a case ID for tracking.

For the full request/response schema, see the API documentation.

Async results with webhooks

Case processing takes a few seconds. Include a webhook_url to get results pushed to you when done:

{  "text": "Case details...",  "webhook_url": "https://your-app.com/mdl-callback"}

We POST the results to your URL when processing completes — case ID, matches, confidence scores, everything.

You can also poll /api/v1/match/{caseId}/status if you prefer.

Rate limits

The API returns your quota in response headers. When you hit your monthly limit, you get a 429 with current usage numbers.

API calls count toward the same monthly quota as dashboard and Clio submissions. They all draw from the same pool.