Moving from v3
A checklist for switching a v3 client to v4.
- Change paths from
/v2/api-integration-v3/...to/v4/...(see Endpoints). - Send all three headers on every call, with
Bearerbefore the key. - Send the patient's IDs in
identifiers, not asid_type+id_value. - Read errors from
error.codeanderror.details[].code, not from message text. - Treat 403
CLINIC_NOT_AUTHORIZEDas a clinic setup issue, not a bad key. - Remove
modeandtest_modefrom requests, and any other field not listed here. - Poll
GET /v4/eligibility-checks/{id}untilCOMPLETE,FAILEDorCANCELLED. - Read answers from
eligible_responsesandother_responses, branching on each row'stpa_idandstatus. - Page the list with
next_cursorinstead of page numbers. - Cancel with the check id only; stop sending
eligibility_idandtpa_name. - Run your client against test IDs before switching production traffic.
Questions or a new clinic to add to your key: contact your Mantys account team, quoting the
request_id for any error.