itemnumbers MBS schedule

Find Medicare Benefits Schedule (MBS) items by item number or by words describing the procedure or service. Returns each match's descriptor, schedule fee and Medicare benefits from the current schedule. Use it first when you have a procedure but not an item number. Never put patient identifiers in the query.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "An item number or its start (for example 3038), or a few words naming the procedure or service (for example gallbladder removal). Never include patient names, dates of birth or other identifying details."
    },
    "limit": {
      "default": 10,
      "description": "How many items to return, 1 to 20. Default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Get one MBS item as published: full descriptor, fees and benefits, item type, dates, EMSN cap if any, and what the descriptor itself says: assistant and anaesthetic flags, hospital-only, time tier, and the items it excludes. Every figure comes from the schedule, never from memory.

{
  "type": "object",
  "properties": {
    "item_number": {
      "type": "string",
      "pattern": "^\\d{1,6}$",
      "description": "An MBS item number, 1 to 6 digits, for example 30445."
    }
  },
  "required": [
    "item_number"
  ],
  "additionalProperties": false
}

Show how the schedule itself ties one item to others: items its descriptor (or another item's descriptor) says are not claimable with it, add-on items performed in association with it, and the neighbouring items filed in the same group and subgroup. Each link quotes the descriptor wording and names the item whose descriptor says it.

{
  "type": "object",
  "properties": {
    "item_number": {
      "type": "string",
      "pattern": "^\\d{1,6}$",
      "description": "An MBS item number, 1 to 6 digits, for example 30445."
    }
  },
  "required": [
    "item_number"
  ],
  "additionalProperties": false
}

Compare a set of MBS items for one occasion with the rules written in their descriptors, as schedule reference information: pairs the schedule says are not claimable together, time tiers met or missed, flags for assistant, anaesthetic and hospital-only items, and the multiple operation rule for Group T8 items with the resulting total of schedule fees (a schedule figure, not a patient charge). It reports what the descriptors say and never drops an item; it does not decide what should be billed. Rules the schedule words in ways that are not coded, such as exempt items, are not checked.

{
  "type": "object",
  "properties": {
    "item_numbers": {
      "minItems": 1,
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d{1,6}$",
        "description": "An MBS item number, 1 to 6 digits, for example 30445."
      },
      "description": "The items performed on one occasion, 1 to 15 item numbers."
    },
    "durations": {
      "default": [],
      "description": "Minutes the service lasted, only for items whose descriptor has a time tier.",
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "item_number": {
            "type": "string",
            "pattern": "^\\d{1,6}$",
            "description": "An MBS item number, 1 to 6 digits, for example 30445."
          },
          "minutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1440
          }
        },
        "required": [
          "item_number",
          "minutes"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "item_numbers"
  ],
  "additionalProperties": false
}

Show how one MBS item's descriptor and schedule fee changed across the schedule releases held here, newest first. Use it to answer what an item paid or said on an earlier date. Only the releases ingested are listed; it is not a complete history of the item.

{
  "type": "object",
  "properties": {
    "item_number": {
      "type": "string",
      "pattern": "^\\d{1,6}$",
      "description": "An MBS item number, 1 to 6 digits, for example 30445."
    }
  },
  "required": [
    "item_number"
  ],
  "additionalProperties": false
}