Interactive Patient Claim — General | RebateRight

curl -X POST https://api.rebateright.com.au/Medicare/patientclaiminteractive/general/v1 \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "patientClaimInteractive": {
    "accountPaidInd": "Y",
    "authorisationDate": "2026-04-13",
    "submissionAuthorityInd": "Y",
    "serviceProvider": {
      "providerNumber": "2447781L"
    },
    "patient": {
      "identity": {
        "givenName": "Clint",
        "familyName": "FLETCHER",
        "dateOfBirth": "2009-02-08"
      },
      "medicare": {
        "memberNumber": "4951525561",
        "memberRefNumber": "3"
      }
    },
    "medicalEvent": [
      {
        "id": "01",
        "medicalEventDate": "2026-04-13",
        "service": [
          {
            "id": "0001",
            "itemNumber": "23",
            "chargeAmount": "15075"
          }
        ]
      }
    ],
    "claimant": {
      "identity": {
        "givenName": "Clint",
        "familyName": "FLETCHER",
        "dateOfBirth": "2009-02-08"
      },
      "medicare": {
        "memberNumber": "4951525561",
        "memberRefNumber": "3"
      }
    }
  }
}'

{
  "status": "MEDICARE_ASSESSED",
  "correlationId": "urn:uuid:MDE00000dd434adf401e4ee3",
  "claimAssessment": {
    "claimId": "MDE0000010042614054286",
    "medicalEvent": [
      {
        "id": "01",
        "eventDate": "2026-04-10",
        "service": [
          {
            "id": "0001",
            "itemNumber": "23",
            "chargeAmount": "15075",
            "assessmentCode": "ASSESSED",
            "benefitPaid": "4390",
            "numberOfPatientsSeen": "1"
          },
          {
            "id": "0002",
            "itemNumber": "57506",
            "chargeAmount": "15075",
            "assessmentCode": "ASSESSED",
            "benefitPaid": "2905"
          }
        ]
      }
    ]
  }
}

The general interactive patient claim endpoint submits a Medicare patient claim for professional services that do not require a referral or request. The claimant authorises the submission and receives the Medicare benefit; the patient received the service. They may be the same person.

Response handling

Every 200 response carries a status indicating the claim outcome — MEDICARE_ASSESSED, MEDICARE_PENDABLE, MEDICARE_PENDED, or MEDICARE_REJECTED. Per-service outcomes are reported via assessmentCode on each medicalEvent[].service[]. See the response schema for the full handling tables.

Error codes

Medicare reason codes appear on three fields: claim-level claimAssessment.error.code, per-service claimAssessment.medicalEvent[].service[].error.code, and serviceMessage[].code on 400 responses. Map all of them to user-facing descriptions via the Services Australia reason-code lookup.

The **general** interactive patient claim endpoint submits a Medicare patient claim for professional services that do not require a referral or request. The claimant authorises the submission and receives the Medicare benefit; the patient received the service. They may be the same person. ### Response handling Every `200` response carries a `status` indicating the claim outcome — `MEDICARE_ASSESSED`, `MEDICARE_PENDABLE`, `MEDICARE_PENDED`, or `MEDICARE_REJECTED`. Per-service outcomes are reported via `assessmentCode` on each `medicalEvent[].service[]`. See the response schema for the full handling tables. ### Error codes Medicare reason codes appear on three fields: claim-level `claimAssessment.error.code`, per-service `claimAssessment.medicalEvent[].service[].error.code`, and `serviceMessage[].code` on `400` responses. Map all of them to user-facing descriptions via the [Services Australia reason-code lookup](https://www.servicesaustralia.gov.au/look-up-medicare-reason-code).

Authentication

x-api-keystring

API Key authentication via header

x-minor-idstring

API Key authentication via header

Request

This endpoint expects an object.

patientClaimInteractiveobjectRequired

correlationIdstringOptional

Optional. Supply a unique transaction ID in the format urn:uuid:{MinorId}{16 hex chars}. If omitted, RebateRight generates one automatically.

Response

Claim submitted successfully.

statusenum

Overall claim outcome. The value drives response handling on your side:

Status	Meaning	Typical handling
`MEDICARE_ASSESSED`	Claim assessed by Medicare. One or more services have a `benefitPaid` and an `assessmentCode` of `ASSESSED`.	Treat as paid; payment is in progress to the claimant.
`MEDICARE_PENDABLE`	Claim held by your software; Medicare has not yet received it for assessment. Typically triggered by a service returning `ACCEPTABLE_ERROR` (e.g. possible duplicate).	Surface the reason to the claimant. Within 60 minutes, resubmit with the same `correlationId` to either (a) send it to a Medicare operator for manual assessment (→ `MEDICARE_PENDED`), or (b) auto-resolve it by adding the appropriate override indicator or service text (→ may go to `MEDICARE_ASSESSED`).
`MEDICARE_PENDED`	Claim accepted by Medicare and queued for manual operator assessment. No `assessmentCode` or `benefitPaid` will follow via the API.	Record the `claimId` for reconciliation and issue the claimant a printed Lodgement Advice (legislatively required). Medicare notifies the claimant directly of the outcome — no downstream API notification is sent.
`MEDICARE_REJECTED`	Claim rejected outright. Check `claimAssessment.error` (claim-level) or per-service `error` for the reason.	Do not resubmit without correcting the underlying issue.

correlationIdstring

Echo of the request correlationId (or the one generated by RebateRight when the request omitted it).

claimAssessmentobject

Medicare's assessment of the submitted claim.

Errors

400

Bad Request Error