Pre-assignment (PDF)
Pre-assignment (PDF)
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](/assignment-of-benefit/pre-assignment).
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
| Status | Content type | Meaning |
|--------|--------------|---------|
| `200` | `application/pdf` | The rendered pre-assignment agreement. |
| `400` | `text/plain` | The request was malformed or missing a required field. |
Authentication
x-api-keystring
API Key authentication via header
x-minor-idstring
API Key authentication via header
Request
This endpoint expects an object.
serviceProviderName
The servicing provider’s name, printed under Details of the professional alongside the provider number.
serviceStream
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.
| Value | Statement (future tense) | Date column | Description column |
|-------|--------------------------|-------------|--------------------|
| `general` | …the health professional who will render the service(s). | Date of service | Basic service description |
| `pathology` | …the approved pathology practitioner who will render the requested pathology service(s)… | Date of specimen collection | Description of service |
| `diagnosticImaging` | …the diagnostic imaging provider who will render the requested diagnostic imaging service(s)… | Date of imaging procedure | Description 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:
serviceProvider
assignments
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, aligned with Services Australia BBSW expectations for the 1 July 2026 data set.