Bulk Bill Claim — General | RebateRight

How do I lodge a bulk bill claim for general services?

Through this endpoint, with serviceTypeCode: O. The claim limits and the general-only rules are below.

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.

Authentication

x-api-keystring

API Key authentication via header

x-minor-idstring

Your Minor ID is three uppercase letters followed by five digits, such as MDE00001. Send the Minor ID exactly as issued. A malformed value gets a 400 with “The Minor ID is not valid.” on every endpoint.

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.

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