For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
    • Home
  • API Reference
        • POSTBulk Bill Claim — General
        • POSTBulk Bill Claim — Specialist
        • POSTBulk Bill Claim — Pathology
        • POSTBulk Bill Payment Report
        • POSTBulk Bill Processing Report
        • POSTAssignment of Benefit (PDF)
  • Guides
    • Minor ID Setup
    • Architecture
    • Security & Governance
    • PRODA
    • DVA Integration
    • AIR Integration
    • Integration test data
    • Troubleshooting
LogoLogo
API ReferenceMedicare ClaimingBulk Bill Claim

Bulk Bill Claim — General

||View as Markdown|
POST
/Medicare/bulkbillstoreforward/general/v1
POST
/Medicare/bulkbillstoreforward/general/v1
$curl -X POST https://api.rebateright.com.au/Medicare/bulkbillstoreforward/general/v1 \
>     -H "x-api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "claim": {
>    "serviceTypeCode": "O",
>    "serviceProvider": {
>      "providerNumber": "2447781L"
>    },
>    "medicalEvent": [
>      {
>        "id": "01",
>        "authorisationDate": "2025-09-16",
>        "createDateTime": "2025-09-16T10:30:00+10:00",
>        "medicalEventDate": "2025-09-16",
>        "submissionAuthorityInd": "Y",
>        "patient": {
>          "identity": {
>            "givenName": "Edmond",
>            "familyName": "FLETCHER",
>            "dateOfBirth": "1986-12-18"
>          },
>          "medicare": {
>            "memberNumber": "4951525561",
>            "memberRefNumber": "2"
>          }
>        },
>        "service": [
>          {
>            "id": "0001",
>            "itemNumber": "23",
>            "chargeAmount": "15000"
>          }
>        ]
>      }
>    ]
>  }
>}'
1{
2  "claimId": "F3848@",
3  "status": "SUCCESS",
4  "correlationId": "urn:uuid:MDE000009bb6cd1c92674e1c"
5}
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.
Was this page helpful?
Previous

Eligibility Check Disclaimer (PDF)

Next

Bulk Bill Claim — Specialist

Built with

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 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