Bulk Bill Claim — Specialist

View as Markdown
Submit a bulk bill claim for **specialist, allied health, or diagnostic imaging** services. Use `serviceTypeCode: S`. See the [Bulk Bill Claim guide](/bulk-bill-claim) for claim structure and [assignment of benefit](/assignment-of-benefit). **Mixing rule:** specialist and diagnostic-imaging services may share the same medical event. **Pathology** services must be submitted through the [Pathology endpoint](/api-reference/medicare-claiming/bulk-bill-claim/bulk-bill-claim-pathology). ## 📋 Referral requirement Every medical event must satisfy **one** of the following, or Medicare rejects the claim with `2030`: | Option | How to send it | | --- | --- | | A referral exists | `referral` with `typeCode` of `S` or `D` | | No referral document exists | `referralOverrideCode` of `H`, `L`, `E`, or `N` | | The provider self-deems the service | `selfDeemedCode` of `SD` or `SS` on at least one service | `referralOverrideCode` is exclusive: it cannot be combined with `referral`, nor with `selfDeemedCode`. ## 📐 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.

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 (F3849@) 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