Skip to navigation

Pre-assignment (PDF)

View as Markdown
What does the patient sign before a bulk-billed service?

This endpoint produces it: the pre-assignment Assignment of Benefit form as a PDF, one signable page for each assignment.

Returns application/pdf: a printable Medicare bulk bill pre-assignment Assignment of Benefit agreement: the form a patient signs to assign their Medicare benefit before the service.

For what pre-assignment is, when to use it instead of post-assignment, and the signing and retention obligations, see the Pre-assignment guide.

Supply the servicing provider, the serviceStream, and one or more assignments. Each renders as a complete, signable page, so one request can produce a batch. Because a pre-assignment precedes the claim, this request is not the bulk bill claim payload. This endpoint renders the document; it does not lodge a claim or call Services Australia.

A pre-assignment cannot be used for Child Dental Benefits Schedule (CDBS) claims.

How the form is chosen

You set the service stream explicitly with serviceStream (general, pathology, or diagnosticImaging). It selects the assignor’s statement and the date-column label for every page of the request.

Response

StatusContent typeMeaning
200application/pdfThe rendered pre-assignment agreement.
400text/plainThe request was malformed or missing a required field.

Authentication

x-api-keystring
API Key authentication via header
x-minor-idstring

Your Minor ID is three uppercase letters followed by five digits, such as MDE00001. Send the Minor ID exactly as issued. A malformed value gets a 400 with "The Minor ID is not valid." on every endpoint.

Request

This endpoint expects an object.
serviceProviderNamestringRequired

The servicing provider's name, printed under Details of the professional alongside the provider number.

serviceStreamenumRequired

The service stream. It selects the assignor's statement, the date-column label, and the description-column label printed on every page of this request.

ValueStatement (future tense)Date columnDescription column
general…the health professional who will render the service(s).Date of serviceBasic service description
pathology…the approved pathology practitioner who will render the requested pathology service(s)…Date of specimen collectionDescription of service
diagnosticImaging…the diagnostic imaging provider who will render the requested diagnostic imaging service(s)…Date of imaging procedureDescription of service

A specialist or allied-health attendance uses general. Pathology Group P9 (simple in-rooms tests) also uses general, the way Services Australia defines the streams.

Allowed values:
serviceProviderobjectRequired
assignmentslist of objectsRequired
One entry per patient. Each renders as a complete, signable agreement on its own page.

Response

PDF bytes, a Medicare online bulk bill pre-assignment Assignment of Benefit agreement, carrying the minimum data set Services Australia requires.