API ReferenceMedicare ClaimingBulk Bill Claim

Bulk Bill Claim — General

View as Markdown
Submit a bulk bill claim for **general (out-of-hospital)** Medicare services. Use `serviceTypeCode: O`. 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**. **General-only constraint:** do **not** set `referral`, `referralOverrideCode`, or `selfDeemedCode` on this endpoint — they apply only to specialist and pathology claims. ## 📑 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. F3848@). 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