For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
    • Home
  • API Reference
      • POSTConcession Verification
  • Guides
    • Minor ID Setup
    • Architecture
    • Security & Governance
    • PRODA
    • DVA Integration
    • AIR Integration
    • Integration test data
    • Troubleshooting
LogoLogo
API ReferenceConcession

Concession Verification

||View as Markdown|
POST
/Medicare/concessionverification/v1
POST
/Medicare/concessionverification/v1
$curl -X POST https://api.rebateright.com.au/Medicare/concessionverification/v1 \
>     -H "x-api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "patient": {
>    "identity": {
>      "dateOfBirth": "1958-02-10",
>      "familyName": "Leonard",
>      "givenName": "Bobby"
>    },
>    "medicare": {
>      "memberNumber": "2293653285",
>      "memberRefNumber": "1"
>    }
>  },
>  "dateOfService": "2026-04-09"
>}'
1{
2  "correlationId": "urn:uuid:MDE00000296fd2256b744459",
3  "medicareStatus": {
4    "status": {
5      "code": 0,
6      "text": "Patient is eligible to claim for Medicare with details provided."
7    }
8  },
9  "concessionStatus": {
10    "status": {
11      "code": 0,
12      "text": "Patient Eligible for Concession."
13    }
14  }
15}
Verifies whether a Medicare patient holds a current concession entitlement. RebateRight runs a Medicare identity check first. If the patient is found (including a partial match), a concession check is performed. If the Medicare check fails, only a Medicare error is returned — no concession check is attempted. #### Medicare Status Codes | Code | Meaning | |---|---| | `0` | Patient matched on Medicare | | `9633` | New Medicare card issued — details differ from records | | `9202` | Field-level validation failure — see `serviceMessage` for detail | #### Concession Status Codes | Code | Meaning | |---|---| | `0` | Patient is eligible for concession | | `9685` | No concession entitlement found |
Was this page helpful?
Previous

Service Voucher D1216S (PDF)

Next

Authorisation

Built with

Verifies whether a Medicare patient holds a current concession entitlement.

RebateRight runs a Medicare identity check first. If the patient is found (including a partial match), a concession check is performed. If the Medicare check fails, only a Medicare error is returned — no concession check is attempted.

Medicare Status Codes

CodeMeaning
0Patient matched on Medicare
9633New Medicare card issued — details differ from records
9202Field-level validation failure — see serviceMessage for detail

Concession Status Codes

CodeMeaning
0Patient is eligible for concession
9685No concession entitlement found

Authentication

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

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.
medicareStatusobject

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

concessionStatusobject

Concession check outcome. Only present when the Medicare identity check succeeded (exact or partial match); absent when Medicare itself failed.

highestSeveritystring

Present on validation errors. Value is Error.

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

Errors

400
Bad Request Error