Skip to navigation
RebateRight APIDVA

DVA Processing Report

View as Markdown
How did Medicare assess each service on this DVA claim?

That is the question this endpoint answers, with the processing detail for every medical event and service in the claim.

Retrieve a processing report for a DVA medical claim submitted through Medicare, from the same Minor ID (transmitting location) that submitted the claim.

📑 Response — status

ValueMeaning
COMPLETEReport is available; claimAssessment is populated.
REPORT_NOT_READYClaim located but assessment / payment is not finalised yet — retry later.
REPORT_NOT_FOUNDNo matching claim for this location, provider, and identifiers.
REPORT_EXPIREDLodgement is outside the six-month retrieval window.

The report summarises how the claim was assessed: totals at claim level, and per medical event and service (assessment codes, benefit and charge amounts, veteran details as held when assessed).

Reports can be retrieved for six months from the date the original claim was lodged, as many times as needed. Only the location that submitted the claim may request its report.

Malformed requests (for example an invalid correlationId) receive HTTP 400 — see the 400 response examples.

Authentication

x-api-keystring
API Key authentication via header
x-minor-idstring

Your Minor ID is three uppercase letters followed by five digits, such as MDE00001. Send the Minor ID exactly as issued. A malformed value gets a 400 with “The Minor ID is not valid.” on every endpoint.

Request

This endpoint expects an object.
correlationIdstringRequired

Transaction identifier from the successful DVA medical claim response; must match exactly what was returned when the claim was accepted. Format is urn:uuid: + Minor ID (8 characters) + 16 hexadecimal characters (33 characters total), for example urn:uuid:MDE0000015181774ceb04e27.

payeeProviderobjectRequired

Payee provider from the original claim transmission; use the same values as on that claim.

Response

OK
statusenum

Outcome of the report request.

ValueMeaning
COMPLETEReport returned with claim assessment data
REPORT_NOT_READYReport not ready yet — retry later
REPORT_NOT_FOUNDReport not found
REPORT_EXPIREDReport has expired
Allowed values:
correlationIdstring

Echo of the correlationId sent on the request.

claimAssessmentobjectOptional

Present when status is COMPLETE. Assessment snapshot for the claim; Medicare may include additional properties beyond those listed.

Errors

400
Bad Request Error