Bulk Bill Claim — Specialist | RebateRight

Submit a bulk bill claim for specialist, allied health, or diagnostic imaging services. Use serviceTypeCode: S.

A claim may contain up to 80 medical events, each with up to 14 services. medicalEventDate must not be more than 1 year before submission.

Mixing rule: specialist and diagnostic-imaging services may share the same medical event; pathology services must be submitted via the Pathology endpoint.

📑 Referral requirement

Each medical event must satisfy one of the following — otherwise Medicare rejects the claim:

referral is supplied with typeCode of S (specialist / allied health) or D (diagnostic imaging), or
referralOverrideCode is set to H (hospital), L (lost), E (emergency), or N (not required), or
selfDeemedCode is set to SD or SS on at least one service.

📑 Error codes

Validation and business-rule failures return 400 with serviceMessage[].code populated by Medicare. Use the Services Australia lookup tool to map each code to a human-readable description.

Submit a bulk bill claim for **specialist, allied health, or diagnostic imaging** services. Use `serviceTypeCode: S`. A claim may contain up to **80 medical events**, each with up to **14 services**. `medicalEventDate` must not be more than **1 year before submission**. **Mixing rule:** specialist and diagnostic-imaging services may share the same medical event; **pathology** services must be submitted via the Pathology endpoint. ## 📑 Referral requirement Each medical event must satisfy **one** of the following — otherwise Medicare rejects the claim: - `referral` is supplied with `typeCode` of `S` (specialist / allied health) or `D` (diagnostic imaging), **or** - `referralOverrideCode` is set to `H` (hospital), `L` (lost), `E` (emergency), or `N` (not required), **or** - `selfDeemedCode` is set to `SD` or `SS` on at least one service. ## 📑 Error codes Validation and business-rule failures return **`400`** with `serviceMessage[].code` populated by Medicare. Use the [Services Australia lookup tool](https://www.servicesaustralia.gov.au/look-up-medicare-reason-code) to map each code to a human-readable description.

Authentication

x-api-keystring

API Key authentication via header

x-minor-idstring

API Key authentication via header

Request

This endpoint expects an object.

claimobjectRequired

correlationIdstringOptional

Optional. Supply a unique transaction ID in the format urn:uuid:{MinorId}{16 hex chars} (33 characters total, e.g. urn:uuid:MDE00000a1b2c3d4e5f6a7b8). If the same correlationId is submitted twice, the second request is rejected with error 9777. If omitted, RebateRight generates one automatically.

Response

OK — 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. Format is a letter prefix, 4 digits, and a @ suffix (e.g. F3849@). Use this to retrieve the Processing Report once the claim has been assessed.

statusstring

Always 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