Skip to navigation
RebateRight APIConcession

Concession Verification

View as Markdown
Does this patient hold a current concession entitlement?

That is the question this endpoint answers. It matches the patient with Medicare first, then checks the concession.

Verifies whether a Medicare patient holds a current concession entitlement.

RebateRight runs a Medicare identity check first. If the patient matches — including a partial match such as a corrected IRN — the concession check is performed. If the Medicare check does not match, concessionStatus is still returned but carries code 9781 (check not undertaken). A request that fails field validation (for example a card number that does not pass the Medicare check-digit routine) returns 400 with serviceMessage and no status blocks.

Medicare Status Codes (medicareStatus.status.code)

CodeMeaning
0Patient matched on Medicare
8016Accepted, but not an exact match (for example a wrong IRN) — currentMembership holds the correct value
9633New Medicare card issued — details differ from records
9650Card number and/or patient details did not match Medicare

Concession Status Codes (concessionStatus.status.code)

CodeMeaning
0Patient is eligible for concession
9685No concession entitlement found
9781Check not undertaken — the Medicare identity check did not match

Validation Errors (400)

CodeMeaning
9202A submitted field failed validation — see serviceMessage for detail

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.
patientobjectRequired
dateOfServicedateOptional
Date the service is being provided. Defaults to today if not supplied. Cannot be in the future or more than 2 years in the past.

Response

OK
correlationIdstring
Unique identifier for this transaction. Use for tracing and support.
medicareStatusobjectOptional

Medicare identity check outcome. Returned whenever Medicare responded (including partial matches).

concessionStatusobjectOptional

Concession check outcome. Present on every 200 response — when the Medicare check does not match it carries code 9781 (check not undertaken). Absent only on 400 validation errors.

highestSeveritystringOptional

Present on validation errors. Value is Error.

serviceMessagelist of objectsOptional
Present on validation errors. Each entry describes one failure.

Errors

400
Bad Request Error