GET
/case-lookup/summarize/{id}Poll an on-demand case summary
orderSummaries/riskLevel/caseSummary are returned on every poll (not just once COMPLETE) so per-order progress shows up as each order's own summary finishes.
Overview
orderSummaries/riskLevel/caseSummary are returned on every poll (not just once COMPLETE) so per-order progress shows up as each order's own summary finishes. Requires case.read.
Auth API keyPermission case.read
Send your API key in the
X-CasePrimus-Api-Key header. See Authentication for how to create a key, and Rate limits & errors for how requests are counted.Parameters
| Name | In | Description |
|---|---|---|
idstring Required | path | The id returned when the resource was created. |
Example request
Replace CASEPRIMUS_API_KEY with your key.
Request
BASE="https://api.caseprimus.ai/api/caseprimus/v1" curl "$BASE/case-lookup/summarize/SUMMARIZE_ID" \ -H "X-CasePrimus-Api-Key: $CASEPRIMUS_API_KEY"
const BASE = "https://api.caseprimus.ai/api/caseprimus/v1"; const res = await fetch(BASE + "/case-lookup/summarize/SUMMARIZE_ID", { method: "GET", headers: { "X-CasePrimus-Api-Key": process.env.CASEPRIMUS_API_KEY, }, }); const data = await res.json();
import os import requests BASE = "https://api.caseprimus.ai/api/caseprimus/v1" res = requests.request( "GET", BASE + "/case-lookup/summarize/SUMMARIZE_ID", headers={"X-CasePrimus-Api-Key": os.environ["CASEPRIMUS_API_KEY"]}, ) data = res.json()
Responses
200Current summarization status.
| Field | Description |
|---|---|
_idstring | |
statusenum | PENDINGCOMPLETEFAILED |
riskLevelstring or null | |
caseSummarystring or null | |
riskJustificationstring or null | |
orderSummariesarray of object | |
errorstring or null |
Response 200
{
"_id": "CPCSS0exampledemo0001",
"status": "PENDING",
"riskLevel": null,
"caseSummary": null,
"riskJustification": null,
"orderSummaries": [
{
"orderNumber": "1",
"status": "COMPLETE",
"summary": "Interim order granting a short adjournment."
},
{
"orderNumber": "2",
"status": "PENDING"
}
],
"error": null
}{
"_id": "CPCSS0exampledemo0001",
"status": "COMPLETE",
"riskLevel": "MODERATE",
"caseSummary": "A commercial dispute currently at the arguments stage.",
"riskJustification": "Multiple interim orders indicate active contestation, but no adverse final order yet.",
"orderSummaries": [
{
"orderNumber": "1",
"status": "COMPLETE",
"summary": "Interim order granting a short adjournment."
}
],
"error": null
}400This summary request does not exist.
Response 400
{
"httpStatusCode": 400,
"code": 60435,
"message": "This case summary request does not exist",
"appError": true
}403Caller lacks the case.read permission.
Error responses share one shape, listed on Rate limits & errors.