1. Verify Patient

View as Markdown
This endpoint receives patient details and verifies patient information with Medicare. ### 🎨 How It Works - First RebateRight validates the inputs for expected format and required information. - Then it Uses Medicare Patient Verification Check service behind the scenes to provide the results. - The response may include correct data if there is a mismatch. ### πŸ› οΈ Example Requests and Responses To explore sample requests and responses, go to the Example Request section and use the options in the top-right corner to view different requests along with their corresponding responses from RebateRight. <img src="https://content.pstmn.io/b64ccbc5-883c-4818-963f-5ac86cfa065f/aW1hZ2UucG5n" alt="How%20to%20Choose%20a%20Sample%20Request" width="100%"> ### πŸ” Medicare Verification Process #### πŸͺͺ Medicare Card Number If the Medicare card number is incorrect, verification fails. Medicare does not return corrected information. **Response** > The card number and/or patient details submitted did not match Medicare checks. Please verify the details and resubmit with additional information if available. #### πŸŽ‚ Date of Birth If the date of birth is the only incorrect field, Medicare will indicate that the DOB is incorrect, but does not return the correct value. **Response** > Patient Verification has been accepted however patient details were not an exact match. Please check patient Date of Birth before claiming. If other fields are also incorrect, verification fails and no corrections are provided. **Response** > The card number and/or patient details submitted did not match Medicare checks. Please verify the details and resubmit with additional information if available. #### πŸ”’ Medicare Reference Number If this is the only incorrect field, Medicare returns the correct reference number to help you correct it. **Response** > Patient Verification has been accepted however patient details were not an exact match. Please check patient Individual Reference Number (IRN) before claiming. Correct Medicare Reference Number: 3. If other fields are also incorrect, verification fails and no corrections are provided. **Response** > The card number and/or patient details submitted did not match Medicare checks. Please verify the details and resubmit with additional information if available. #### πŸ§‘ Given Name Medicare validates the **first five characters of the patient’s given name**. If these match Medicare records, the request can still be accepted even if the full given name differs. **Example:** Submitted: **ELIZA** Medicare record: **ELIZABETH** This will be accepted. If the given name is the only incorrect field, Medicare returns the correct given name to assist with updating records. **Response** > Patient Verification has been accepted however patient details were not an exact match. Please check patient Given Name before claiming. Correct Given Name: CLINT. If other fields are also incorrect, verification fails and no corrections are provided. **Response** > The card number and/or patient details submitted did not match Medicare checks. Please verify the details and resubmit with additional information if available. #### πŸ‘ͺ Family Name & Sex These fields are optional. If one or both of them are incorrect, verification still succeeds. Medicare ignores mismatches in these fields and does not report or correct them. **Response** > "Patient is eligible to claim for Medicare with details provided." #### πŸ†• New Medicare Card Issued if a new Medicare card has been issued for the patient, Medicare provides the correct Medicare Number, Reference Number, and Given Name. **Response** > A new Medicare card has been issued. Please confirm your records with the patient and if required update for any future claims. Correct Medicare Number: 6951393352. Correct Medicare Reference Number: 2. Correct Given Name: SAM."

Authentication

x-api-keystring
API Key authentication via header

Headers

x-minor-idstringOptional

Request

This endpoint expects an object.
PatientSexstringRequired
PatientGivenNamestringRequired
PatientFamilyNamestringRequired
PatientDateOfBirthdateRequired
PatientMedicareNumberstringRequired
PatientMedicareRefNumberstringRequired

Response headers

Request-Contextstring

Response

OK
Reasonstring
Verifiedboolean
CorrectSexany
CorrectGivenNameany
CorrectFamilyNameany
CorrectDateOfBirthany
CorrectMedicareNumberany
CorrectMedicareReferenceNumberany