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
        • POSTInteractive Patient Claim — General
        • POSTInteractive Patient Claim — Specialist
        • POSTInteractive Patient Claim — Pathology
        • POSTSame Day Delete
  • Guides
    • Minor ID Setup
    • Architecture
    • Security & Governance
    • PRODA
    • DVA Integration
    • AIR Integration
    • Integration test data
    • Troubleshooting
LogoLogo
API ReferenceMedicare ClaimingInteractive Patient Claims

Interactive Patient Claim — General

||View as Markdown|
POST
/Medicare/patientclaiminteractive/general/v1
POST
/Medicare/patientclaiminteractive/general/v1
$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"
>      }
>    }
>  }
>}'
1{
2  "status": "MEDICARE_ASSESSED",
3  "correlationId": "urn:uuid:MDE00000dd434adf401e4ee3",
4  "claimAssessment": {
5    "claimId": "MDE0000010042614054286",
6    "medicalEvent": [
7      {
8        "id": "01",
9        "eventDate": "2026-04-10",
10        "service": [
11          {
12            "id": "0001",
13            "itemNumber": "23",
14            "chargeAmount": "15075",
15            "assessmentCode": "ASSESSED",
16            "benefitPaid": "4390",
17            "numberOfPatientsSeen": "1"
18          },
19          {
20            "id": "0002",
21            "itemNumber": "57506",
22            "chargeAmount": "15075",
23            "assessmentCode": "ASSESSED",
24            "benefitPaid": "2905"
25          }
26        ]
27      }
28    ]
29  }
30}
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).
Was this page helpful?
Previous

Assignment of Benefit (PDF)

Next

Interactive Patient Claim — Specialist

Built with

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.

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:

StatusMeaningTypical handling
MEDICARE_ASSESSEDClaim 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_PENDABLEClaim 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_PENDEDClaim 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_REJECTEDClaim rejected outright. Check claimAssessment.error (claim-level) or per-service error for the reason.Do not resubmit without correcting the underlying issue.
Allowed values:
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