For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://docs.rebateright.com.au/api-reference/medicare-claiming/bulk-bill-claim/llms.txt. For full documentation content, see https://docs.rebateright.com.au/api-reference/medicare-claiming/bulk-bill-claim/llms-full.txt. # Assignment of Benefit (PDF) POST https://api.rebateright.com.au/AoB Content-Type: application/json Returns **`application/pdf`**: a printable Medicare bulk bill **Assignment of Benefit** agreement, generated from your bulk bill claim payload. ### Post-assignment only The PDF always records **Assignment type: Post assignment**. RebateRight does **not** generate pre-assignment AoB PDFs through this endpoint. ### Format A minimal online-claiming layout aligned with **Services Australia** requirements for Medicare online claiming bulk bill assignment. The PDF uses the online title **MEDICARE - ONLINE CLAIMING BULK BILL ASSIGNMENT OF BENEFIT AGREEMENT**. This is **not** the **DB4** (Bulk Bill Assignment Advice) paper form used in traditional workflows. Depending on your process and pathology/request rules, you may still need to issue a DB4-style printed record — see current Services Australia bulk bill claiming guidance. ### PDF contents For each medical event: patient name; assignment details (date, post-assignment flag, whether the assignor is the patient); servicing professional; MBS items with the date column appropriate to the service stream (date of service, specimen collection, or imaging procedure); a **Statement of Assignor's Agreement** using the standard Services Australia text for general, pathology, or diagnostic imaging streams; and a signature line for the patient or assignor. ### Regulatory context From **1 July 2026**, patient consent software must support assignment of benefit, including pre- and post-assignment where applicable. Use this PDF to produce a clear post-assignment agreement record. Retain and present records as required by Services Australia and your clinical governance. Reference: https://docs.rebateright.com.au/api-reference/medicare-claiming/bulk-bill-claim/assignment-of-benefit-pdf ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: collection version: 1.0.0 paths: /AoB: post: operationId: assignment-of-benefit-pdf summary: Assignment of Benefit (PDF) description: > Returns **`application/pdf`**: a printable Medicare bulk bill **Assignment of Benefit** agreement, generated from your bulk bill claim payload. ### Post-assignment only The PDF always records **Assignment type: Post assignment**. RebateRight does **not** generate pre-assignment AoB PDFs through this endpoint. ### Format A minimal online-claiming layout aligned with **Services Australia** requirements for Medicare online claiming bulk bill assignment. The PDF uses the online title **MEDICARE - ONLINE CLAIMING BULK BILL ASSIGNMENT OF BENEFIT AGREEMENT**. This is **not** the **DB4** (Bulk Bill Assignment Advice) paper form used in traditional workflows. Depending on your process and pathology/request rules, you may still need to issue a DB4-style printed record — see current Services Australia bulk bill claiming guidance. ### PDF contents For each medical event: patient name; assignment details (date, post-assignment flag, whether the assignor is the patient); servicing professional; MBS items with the date column appropriate to the service stream (date of service, specimen collection, or imaging procedure); a **Statement of Assignor's Agreement** using the standard Services Australia text for general, pathology, or diagnostic imaging streams; and a signature line for the patient or assignor. ### Regulatory context From **1 July 2026**, patient consent software must support assignment of benefit, including pre- and post-assignment where applicable. Use this PDF to produce a clear post-assignment agreement record. Retain and present records as required by Services Australia and your clinical governance. tags: - subpackage_medicareClaiming.subpackage_medicareClaiming/bulkBillClaim parameters: - name: x-api-key in: header required: true schema: type: string responses: '200': description: >- PDF bytes — **Medicare online** bulk bill Assignment of Benefit (post-assignment), aligned with Services Australia BBSW expectations. content: application/octet-stream: schema: type: string format: binary '400': description: >- Validation or business-rule failure; body includes `serviceMessage` entries and `correlationId`. content: application/json: schema: $ref: '#/components/schemas/PostAobRequestBadRequestError' requestBody: content: application/json: schema: type: object properties: correlationId: type: string description: >- 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. claim: $ref: >- #/components/schemas/AoBPostRequestBodyContentApplicationJsonSchemaClaim required: - claim servers: - url: https://api.rebateright.com.au - url: https://test-api.rebateright.com.au components: schemas: AoBPostRequestBodyContentApplicationJsonSchemaClaimServiceProvider: type: object properties: providerNumber: type: string required: - providerNumber title: AoBPostRequestBodyContentApplicationJsonSchemaClaimServiceProvider AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatientIdentity: type: object properties: givenName: type: string familyName: type: string dateOfBirth: type: string format: date required: - givenName - familyName - dateOfBirth title: >- AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatientIdentity AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatientMedicare: type: object properties: memberNumber: type: string memberRefNumber: type: string required: - memberNumber - memberRefNumber title: >- AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatientMedicare AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatient: type: object properties: identity: $ref: >- #/components/schemas/AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatientIdentity medicare: $ref: >- #/components/schemas/AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatientMedicare required: - identity - medicare title: >- AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatient AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsServiceItems: type: object properties: id: type: string itemNumber: type: string chargeAmount: type: string aftercareOverrideInd: type: string required: - id - itemNumber - chargeAmount - aftercareOverrideInd title: >- AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsServiceItems AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItems: type: object properties: id: type: string authorisationDate: type: string format: date createDateTime: type: string format: date-time medicalEventDate: type: string format: date submissionAuthorityInd: type: string description: Must be `Y`. patient: $ref: >- #/components/schemas/AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsPatient service: type: array items: $ref: >- #/components/schemas/AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItemsServiceItems required: - id - authorisationDate - createDateTime - medicalEventDate - submissionAuthorityInd - patient - service title: AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItems AoBPostRequestBodyContentApplicationJsonSchemaClaim: type: object properties: serviceTypeCode: type: string description: >- Service type code matching the associated bulk bill claim (`O`, `S`, or `P`). serviceProvider: $ref: >- #/components/schemas/AoBPostRequestBodyContentApplicationJsonSchemaClaimServiceProvider medicalEvent: type: array items: $ref: >- #/components/schemas/AoBPostRequestBodyContentApplicationJsonSchemaClaimMedicalEventItems required: - serviceTypeCode - serviceProvider - medicalEvent title: AoBPostRequestBodyContentApplicationJsonSchemaClaim AoBPostResponsesContentApplicationJsonSchemaServiceMessageItems: type: object properties: code: type: string description: Medicare error code. severity: type: string reason: type: string description: Human-readable error message. required: - code - severity - reason title: AoBPostResponsesContentApplicationJsonSchemaServiceMessageItems PostAobRequestBadRequestError: type: object properties: highestSeverity: type: string description: Highest severity level across all messages. E.g. `Error`. serviceMessage: type: array items: $ref: >- #/components/schemas/AoBPostResponsesContentApplicationJsonSchemaServiceMessageItems correlationId: type: string required: - highestSeverity - serviceMessage - correlationId title: PostAobRequestBadRequestError securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key minorId: type: apiKey in: header name: x-minor-id ``` ## SDK Code Examples ```python import requests url = "https://api.rebateright.com.au/AoB" payload = { "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", "aftercareOverrideInd": "Y" } ] } ] } } headers = { "x-api-key": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.rebateright.com.au/AoB'; const options = { method: 'POST', headers: {'x-api-key': '', 'Content-Type': 'application/json'}, body: '{"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","aftercareOverrideInd":"Y"}]}]}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.rebateright.com.au/AoB" payload := strings.NewReader("{\n \"claim\": {\n \"serviceTypeCode\": \"O\",\n \"serviceProvider\": {\n \"providerNumber\": \"2447781L\"\n },\n \"medicalEvent\": [\n {\n \"id\": \"01\",\n \"authorisationDate\": \"2025-09-16\",\n \"createDateTime\": \"2025-09-16T10:30:00+10:00\",\n \"medicalEventDate\": \"2025-09-16\",\n \"submissionAuthorityInd\": \"Y\",\n \"patient\": {\n \"identity\": {\n \"givenName\": \"Edmond\",\n \"familyName\": \"FLETCHER\",\n \"dateOfBirth\": \"1986-12-18\"\n },\n \"medicare\": {\n \"memberNumber\": \"4951525561\",\n \"memberRefNumber\": \"2\"\n }\n },\n \"service\": [\n {\n \"id\": \"0001\",\n \"itemNumber\": \"23\",\n \"chargeAmount\": \"15000\",\n \"aftercareOverrideInd\": \"Y\"\n }\n ]\n }\n ]\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("x-api-key", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.rebateright.com.au/AoB") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["x-api-key"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"claim\": {\n \"serviceTypeCode\": \"O\",\n \"serviceProvider\": {\n \"providerNumber\": \"2447781L\"\n },\n \"medicalEvent\": [\n {\n \"id\": \"01\",\n \"authorisationDate\": \"2025-09-16\",\n \"createDateTime\": \"2025-09-16T10:30:00+10:00\",\n \"medicalEventDate\": \"2025-09-16\",\n \"submissionAuthorityInd\": \"Y\",\n \"patient\": {\n \"identity\": {\n \"givenName\": \"Edmond\",\n \"familyName\": \"FLETCHER\",\n \"dateOfBirth\": \"1986-12-18\"\n },\n \"medicare\": {\n \"memberNumber\": \"4951525561\",\n \"memberRefNumber\": \"2\"\n }\n },\n \"service\": [\n {\n \"id\": \"0001\",\n \"itemNumber\": \"23\",\n \"chargeAmount\": \"15000\",\n \"aftercareOverrideInd\": \"Y\"\n }\n ]\n }\n ]\n }\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.rebateright.com.au/AoB") .header("x-api-key", "") .header("Content-Type", "application/json") .body("{\n \"claim\": {\n \"serviceTypeCode\": \"O\",\n \"serviceProvider\": {\n \"providerNumber\": \"2447781L\"\n },\n \"medicalEvent\": [\n {\n \"id\": \"01\",\n \"authorisationDate\": \"2025-09-16\",\n \"createDateTime\": \"2025-09-16T10:30:00+10:00\",\n \"medicalEventDate\": \"2025-09-16\",\n \"submissionAuthorityInd\": \"Y\",\n \"patient\": {\n \"identity\": {\n \"givenName\": \"Edmond\",\n \"familyName\": \"FLETCHER\",\n \"dateOfBirth\": \"1986-12-18\"\n },\n \"medicare\": {\n \"memberNumber\": \"4951525561\",\n \"memberRefNumber\": \"2\"\n }\n },\n \"service\": [\n {\n \"id\": \"0001\",\n \"itemNumber\": \"23\",\n \"chargeAmount\": \"15000\",\n \"aftercareOverrideInd\": \"Y\"\n }\n ]\n }\n ]\n }\n}") .asString(); ``` ```php request('POST', 'https://api.rebateright.com.au/AoB', [ 'body' => '{ "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", "aftercareOverrideInd": "Y" } ] } ] } }', 'headers' => [ 'Content-Type' => 'application/json', 'x-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.rebateright.com.au/AoB"); var request = new RestRequest(Method.POST); request.AddHeader("x-api-key", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"claim\": {\n \"serviceTypeCode\": \"O\",\n \"serviceProvider\": {\n \"providerNumber\": \"2447781L\"\n },\n \"medicalEvent\": [\n {\n \"id\": \"01\",\n \"authorisationDate\": \"2025-09-16\",\n \"createDateTime\": \"2025-09-16T10:30:00+10:00\",\n \"medicalEventDate\": \"2025-09-16\",\n \"submissionAuthorityInd\": \"Y\",\n \"patient\": {\n \"identity\": {\n \"givenName\": \"Edmond\",\n \"familyName\": \"FLETCHER\",\n \"dateOfBirth\": \"1986-12-18\"\n },\n \"medicare\": {\n \"memberNumber\": \"4951525561\",\n \"memberRefNumber\": \"2\"\n }\n },\n \"service\": [\n {\n \"id\": \"0001\",\n \"itemNumber\": \"23\",\n \"chargeAmount\": \"15000\",\n \"aftercareOverrideInd\": \"Y\"\n }\n ]\n }\n ]\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "x-api-key": "", "Content-Type": "application/json" ] let parameters = ["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", "aftercareOverrideInd": "Y" ] ] ] ] ]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.rebateright.com.au/AoB")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```