Report Info API

Overview

The Report Info API returns lightweight report metadata without running a full validation or opening a chat session. It is suited for header cards, context panels, and report selectors.

Source-backed direct runtime path:

• GET /sdac/report/{reportId}

Widget-safe proxy paths:

• GET /api/ingestion/sdac/report/{reportId}
• GET /api/ingestion/sdac/reports/{reportId}

Authentication and Access

Direct APIM callers must send:

• Authorization: Bearer {access_token}
• Ocp-Apim-Subscription-Key: {subscription_key}

Widget callers should use the same-origin /api/ingestion/sdac/report/{reportId} proxy instead of calling the runtime route directly from the browser. See Authentication for the gateway flow.

Endpoint

Attribute	Value
Endpoint	GET /api/ingestion/sdac/report/{reportId}
Method	GET
Response	JSON

Request

Path Parameters

Parameter	Type	Required	Description
reportId	UUID string	Yes	Report identifier to load for header metadata and totals

Response

{
  "reportId": "8201EDC2-2EDE-4CA1-AF44-D0F5AA185CDB",
  "districtName": "Maplewood Richmond Heights",
  "quarter": "Q3",
  "positions": 21,
  "totalSalary": 438221.17,
  "totalFringe": 126440.52
}

Field	Type	Description
reportId	UUID string	Report identifier that was requested
districtName	string	District display name
quarter	string	Reporting quarter
positions	number	Canonical position count used for the report summary
totalSalary	number	Total claimable salary amount
totalFringe	number	Total claimable fringe amount

Error Cases

Status	Description
400	Invalid reportId format
401	Missing or expired bearer token
403	Invalid subscription key or insufficient scope
404	Report not found
500	Failed to load report info

Example

curl -X GET "$WIDGET_BASE_URL/api/ingestion/sdac/report/8201EDC2-2EDE-4CA1-AF44-D0F5AA185CDB"

Operational Notes

• Use this endpoint when your UI only needs summary metadata and totals.
• Pair it with the Validation API for baseline issues or the Chat API for targeted analysis.