Concession Verification | RebateRight

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"
}'

{
  "correlationId": "urn:uuid:MDE00000296fd2256b744459",
  "medicareStatus": {
    "status": {
      "code": 0,
      "text": "Patient is eligible to claim for Medicare with details provided."
    }
  },
  "concessionStatus": {
    "status": {
      "code": 0,
      "text": "Patient Eligible for 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`)

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

Concession Status Codes (`concessionStatus.status.code`)

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

Validation Errors (`400`)

Code	Meaning
`9202`	A submitted field failed validation — see `serviceMessage` for detail

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`) | Code | Meaning | |---|---| | `0` | Patient matched on Medicare | | `8016` | Accepted, but not an exact match (for example a wrong IRN) — `currentMembership` holds the correct value | | `9633` | New Medicare card issued — details differ from records | | `9650` | Card number and/or patient details did not match Medicare | #### Concession Status Codes (`concessionStatus.status.code`) | Code | Meaning | |---|---| | `0` | Patient is eligible for concession | | `9685` | No concession entitlement found | | `9781` | Check not undertaken — the Medicare identity check did not match | #### Validation Errors (`400`) | Code | Meaning | |---|---| | `9202` | A submitted field failed validation — see `serviceMessage` for detail |

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

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

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

Verifies whether a Medicare patient holds a current concession entitlement.

Medicare Status Codes (`medicareStatus.status.code`)

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

Concession Status Codes (`concessionStatus.status.code`)

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

Validation Errors (`400`)

Code	Meaning
`9202`	A submitted field failed validation — see `serviceMessage` for detail

Medicare Status Codes (medicareStatus.status.code)

Concession Status Codes (concessionStatus.status.code)

Validation Errors (400)

Authentication

Request

Response

Errors

Medicare Status Codes (medicareStatus.status.code)

Concession Status Codes (concessionStatus.status.code)

Validation Errors (400)

Medicare Status Codes (`medicareStatus.status.code`)

Concession Status Codes (`concessionStatus.status.code`)

Validation Errors (`400`)

Medicare Status Codes (`medicareStatus.status.code`)

Concession Status Codes (`concessionStatus.status.code`)

Validation Errors (`400`)