Bulk Bill Claim — General | RebateRight

Submit a bulk bill claim for general Medicare services. Use serviceTypeCode: O.

See the Bulk Bill Claim guide for claim structure and assignment of benefit.

General-only constraint: do not set referral, referralOverrideCode, or selfDeemedCode on this endpoint. They apply only to specialist and pathology claims.

📐 Claim limits

Limit	Value
Medical events per claim	80
Services per medical event	14
Claims per day, per payee provider and location	2500

📅 How far back you can claim

medicalEventDate must not be in the future, and the service must have been rendered within the last year.

🕑 Time zones

Every date-time you send must carry an Australian UTC offset (for example +10:00, +09:30). A UTC Z value is rejected. Most languages produce UTC by default, so convert to Australian local time before serialising.

📑 Error codes

Failures return 400. Each entry in serviceMessage[] names the faulting medical event, and where relevant the service, in its reason text.

Code	Condition	What to do
`9202`	A field value is the wrong format, length, or range	Correct the named field and resubmit
`2030`	A field is valid on its own but breaks a cross-field rule	Read the `reason` text, which states the rule
`2025`	More than 80 medical events in the claim	Split the claim
`2032`	More than 14 services in a medical event	Split the medical event
`9777`	This `correlationId` has already been received	Resubmit with a new one, unless you intended a resubmission
`3004`	Daily claim limit reached for this payee provider and location	Resume the following day

For any code not listed, use the Services Australia lookup tool.

Submit a bulk bill claim for **general** Medicare services. Use `serviceTypeCode: O`. See the [Bulk Bill Claim guide](/bulk-bill-claim) for claim structure and [assignment of benefit](/assignment-of-benefit). **General-only constraint:** do **not** set `referral`, `referralOverrideCode`, or `selfDeemedCode` on this endpoint. They apply only to specialist and pathology claims. ## 📐 Claim limits | Limit | Value | | --- | --- | | Medical events per claim | 80 | | Services per medical event | 14 | | Claims per day, per payee provider and location | 2500 | ## 📅 How far back you can claim `medicalEventDate` must not be in the future, and the service must have been rendered within the last **year**. ## 🕑 Time zones Every date-time you send must carry an **Australian UTC offset** (for example `+10:00`, `+09:30`). A UTC `Z` value is rejected. Most languages produce UTC by default, so convert to Australian local time before serialising. ## 📑 Error codes Failures return **`400`**. Each entry in `serviceMessage[]` names the faulting medical event, and where relevant the service, in its `reason` text. | Code | Condition | What to do | | --- | --- | --- | | `9202` | A field value is the wrong format, length, or range | Correct the named field and resubmit | | `2030` | A field is valid on its own but breaks a cross-field rule | Read the `reason` text, which states the rule | | `2025` | More than 80 medical events in the claim | Split the claim | | `2032` | More than 14 services in a medical event | Split the medical event | | `9777` | This `correlationId` has already been received | Resubmit with a new one, unless you intended a resubmission | | `3004` | Daily claim limit reached for this payee provider and location | Resume the following day | For any code not listed, use the [Services Australia lookup tool](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.

claimobjectRequired

correlationIdstringOptionalformat: "^urn:uuid:.{24}$"=33 characters

Optional. Your unique identifier for this claim, echoed on the response and used to trace or resubmit it.

The value is exactly 33 characters: the literal prefix urn:uuid:, then your 8-character Minor ID, then 16 characters of your own. Despite the prefix, this is not a standard UUID, and a plain UUID is rejected.

urn:uuid:MDE00000a1b2c3d4e5f6a7b8
└───┬───┘└──┬───┘└──────┬───────┘
  prefix  Minor ID   your 16

Resubmitting the same value is treated as a correction to the same claim. A value already used by a different claim is rejected with 9777. Omit the field and RebateRight generates one for you.

Optional. Your unique identifier for this claim, echoed on the response and used to trace or resubmit it. The value is **exactly 33 characters**: the literal prefix `urn:uuid:`, then your 8-character Minor ID, then 16 characters of your own. Despite the prefix, this is **not** a standard UUID, and a plain UUID is rejected. ``` urn:uuid:MDE00000a1b2c3d4e5f6a7b8 └───┬───┘└──┬───┘└──────┬───────┘ prefix Minor ID your 16 ``` Resubmitting the same value is treated as a correction to the same claim. A value already used by a *different* claim is rejected with `9777`. Omit the field and RebateRight generates one for you.

Response

Claim accepted by Medicare for store-and-forward processing. Poll the Bulk Bill Processing Report using the returned claimId to retrieve the assessment outcome.

claimIdstring

Claim identifier assigned by Medicare. Use it to retrieve the Processing Report once the claim has been assessed.

Six characters: a prefix, four digits, then @. The prefix is a letter for services rendered out of hospital (F3848@) and # for services rendered to an admitted patient (#9876@).

A claim ID is unique per lodgement date and payee provider, so two claims lodged on the same date for different payee providers at one location can share it.

statusstring

Transmission status. SUCCESS on a successful submission.

correlationIdstring

Unique identifier for the request, for support tracing. Matches the correlationId you supplied, or the one RebateRight generated for you.

Errors

400

Bad Request Error