Get All MBS Items

View as Markdown
Retrieves the full list of Medicare Benefits Schedule (MBS) items (~6,000 entries), each enriched with RebateRight-derived metadata such as MBS notes and the claim-history limitation period. Every query parameter is optional. Send none and you get the whole catalogue in one response, with no paging fields on the body. ## Errors A `400` carries a **plain-text** message naming the parameter and what to send instead, not a JSON error envelope. > 🔍 **Responses below are truncated** to 2 and 3 items so they stay readable. A real call returns every matching item, with `ItemsCount` reflecting the true total.

Authentication

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

Query parameters

categoryintegerOptional>=1

Return only the items in this MBS category, matching the Category field on each item.

pageNumberintegerOptional>=1

1-based page to return. Send it with pageSize; one without the other returns 400. A page starting past the last item returns an empty MedicareItems array, not an error.

pageSizeintegerOptional>=1

Number of items per page. Send it with pageNumber. There is no upper limit, so you can trade request count against response size.

Response

OK. The full MBS catalogue, or the category and page you asked for.
ItemsCountinteger

Number of items returned in MedicareItems. On a paged response this is the size of the page you received, which on the last page can be smaller than PageSize.

MedicareItemslist of objects
The MBS items for this request. One entry per item number.
TotalCountintegerOptional

Number of items matching the request before paging, across every page. Present only on a paged response. Divide by PageSize and round up for the page count.

PageNumberintegerOptional

The pageNumber that produced this response. Present only on a paged response.

PageSizeintegerOptional

The pageSize that produced this response. Present only on a paged response.