Messages Overview
4 min
message description(s) rxhistoryrequest the provider sends patient demographic information in the rxhistoryrequest message requestors of medication history can request for up to 12 months of history from the date of the request note in an acute setting, if the patient encounter spans multiple days, medication history requests should be sent no more than twice during the patient’s stay rxhistoryresponse the rxhistoryresponse message returns information about outpatient prescriptions that the patient’s pbm/payer has paid for over a selected period of time and contains retail fill data from pharmacies connected to surescripts for medication history up to 300 medications are returned within the dates requested within the last 12 months, starting with the most recent see requesteddates in the rxhistoryrequest xml requirements section of the medication history companion guidefor more information when more medications are available to be returned from the pbm/payers, the pbm/payers must include an approved/reasoncode=aq in the rxhistoryresponse and will continue to receive rxhistoryrequests from surescripts until a total of up to 300 medications have been returned from all of the rxhistoryresponses returned medication history request/response message flow rxhistoryrequest highlights please refer to the ncpdp documentation and the surescripts medication history companion guide for additional details medication history rxhistoryrequests to pbm/payers will include product codes for the requesting service they are outlined below medication history for ambulatory will contain “s00000000000001” medication history for reconciliation will contain “s00000000000002” medication history for populations will contain “s00000000000003” medication history for ltpac will contain “s00000000000013” medication history for health plans will contain “s00000000000005” pbm/payers responding to an rxhistoryrequest should not reject requests due the lack of an npi