Skip to main content

Medicare

Medicare verification allows you to confirm a patient’s eligibility and validate their Medicare details before processing claims. This helps ensure accurate billing and reduces the risk of claim rejections.

Response

A verification response will always return one of the following status codes:

matched

The client’s Medicare details have been successfully verified and match the provided information. This indicates that the patient is eligible and their details are correct.

partial_match

The client exists in the Medicare system, but some of the provided details don’t match exactly. The response will generally include an adviceCode advising which details are incorrect.

no_match

No matching client was found in the Medicare system with the provided details. This could indicate the client doesn’t exist, has never been registered, or all provided details are incorrect.

failed

A system error occurred during the verification process. This is typically a temporary issue and the request can be retried.

Test Data

Use the following test Medicare card numbers to simulate different verification scenarios:
Card NumberScenarioStatus codeAdvice Code
1000000000Exact matchmatched
1000000005System errorfailed
1000000001Medicare number is wrongpartial_matchcheck_medicare_number
1000000002Reference number is wrongpartial_matchcheck_reference_number
1000000003Date of birth is wrongpartial_matchcheck_date_of_birth
1000000004Patient details are wrongpartial_matchcheck_patient_details
1000000006A new card has been issuedpartial_matchnew_card_issued
1000000007We cannot verify this card, do not try again (possible patient deceased, expired RHCA card)partial_matchcannot_confirm
1000000008Matched RHCA cardmatched
Any other numberNo matchno_matchcheck_patient_details

Next Steps

For complete API documentation, visit the Medicare Verification API Reference.