{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"046b39c4-708d-4bd5-a5a1-177d06d815ba","name":"MD Integrations API","description":"## Intro\n\nThe MD Integrations API is a set of HTTP endpoints that help your app integrate with MD Integrations.\n\nThe API is integrated with [DoseSpot](https://www.dosespot.com/), an e-Prescribing system. Our API acts as proxy to DoseSpot: all the required actions on DoseSpot side are handled under the hood by our API.\n\n[](https://drive.google.com/file/d/13CSUQsgAbcIETjONdjBhCrjCzitDdRfe/view?usp=sharing)\n\n**##** Base URL\n\n- [https://api.mdintegrations.com](https://api.mdintegrations.com)\n \n\n## Request and Response Formats\n\nAll API access is over HTTPS. All data is sent and received as JSON.\n\n## Headers\n\nPlease note that all requests require at least these two headers:\n\nContent-Type: application/json\n\nAccept: application/json\n\n## API Errors\n\n#### Error Codes\n\nThe following table describes all the possible HTTP error codes.\n\n| Code | Description |\n| --- | --- |\n| 400 | Bad request |\n| 401 | Unauthorized. This can happen if the access token is invalid, expired or has been revoked |\n| 403 | The access token doesn't have access to perform the requested action |\n| 404 | Resource not found |\n| 418 | API under maintenance |\n| 5XX | An error occurred on the MD Integrations servers. Check MD Integrations Status API for more details or contact the support team |\n\n#### Error Format\n\nThe following table describes the top-level JSON object attributes present in the body of error messages.\n\n| key | value |\n| --- | --- |\n| error | A detailed error message \\* _on production this field is not returned_ |\n| message | Friendly error message. This error message can be used to be displayed to the final user on the app |\n\n## Authentication\n\nTo make any request to the MD Integrations API for Partners, you must first generate a \nbrand new `access token` using your **Client ID** and **Client Secret**.\n\nBoth the **Client ID** and **Client Secret** should be provided to you by the MD Integrations Team.\n\n> ⚠️ Be careful with the Client Secret! It should not be shared and should be kept safe. \n \n\n## Issuing an access token\n\nThe expected flow is shown in the image below:\n\n\n\n[Image source](https://developer.ebay.com/api-docs/static/oauth-client-credentials-grant.html)\n\nAs our authorization API you should use the **Partners > Request access token** endpoint - see it's description for more details.\n\nAfter you've created a new access token, you should be ready to make authenticated requests using the HTTP `Authorization` header with the value `Bearer` . E.g.:\n\n``` http\nGET /partner HTTP/1.1\n...\nAuthorization: Bearer eyJ0eXAiOiJKV1Q...\n\n ```\n\n## Expired tokens\n\nWhenever your token gets expired, you should create a brand new token using the same flow described above.\n\n## Terminology\n\n- **patient**: person in need of treatment by a physician;\n \n- **clinician**: a qualified practitioner of medicine. Alias to MD, doctor and physician;\n \n- **partner**: a partner is a company who sells medications and compounds directly to its patients;\n \n- **medication**: a substance used for medical treatment, especially a medicine or drug, regularly made by pharmaceutical companies;\n \n- **compound**: drug that is specifically mixed and prepared for an individual patient, meaning they are not readily available like a regular OTC medication;\n \n- **prescription**: an instruction written by a clinician that authorizes a patient to be provided by a medication;\n \n- **case**: set of medication prescriptions requests that the partner sends to MD-Integrations on behalf of a patient.\n \n\n## Contact Support\n\n- Email: [support@mdintegrations.com](https://mailto:support@mdintegrations.com)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"14212272","team":1512301,"collectionId":"046b39c4-708d-4bd5-a5a1-177d06d815ba","publishedId":"2sB3BKGUAk","public":true,"publicUrl":"https://documenter-api.postman.tech/view/14212272/2sB3BKGUAk","privateUrl":"https://go.postman.co/documentation/14212272-046b39c4-708d-4bd5-a5a1-177d06d815ba","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.12","publishDate":"2025-08-20T22:28:06.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"Development","id":"081b19c4-31dc-4247-bffd-1bde325108a9","owner":"14212272","values":[{"key":"env","value":"development","enabled":true,"type":"default"},{"key":"url","value":"https://api.mdintegrations.dev","enabled":true,"type":"default"},{"key":"baseUrl","value":"https://api.mdintegrations.dev/v1","enabled":true,"type":"default"},{"key":"base_url_shopify_app","value":"https://connect.mdintegrations.dev","enabled":true,"type":"default"},{"key":"signature","value":"eyJpdiI6IkhrSXQ2VDRaZDBsbGhzR2ErYzFQbHc9PSIsInZhbHVlIjoiK2JlVWhxM2RoY0NvOW5waUtnc0FXRHRqZHRaSGVwK1duSy9oWGpJV2hwWT0iLCJtYWMiOiIwMzQ1NzNkZjE2NjU3NWJiMTFkYzQ3NDQyMDg1MDJjZDBmNzBmY2FkOWQ0YmEzNTZhYTk0ZmRkM2Q5ZDE3ZjNlIiwidGFnIjoiIn0=","enabled":true,"type":"secret"},{"key":"version","value":"2","enabled":true,"type":"default"},{"key":"origin","value":"localhost","enabled":true,"type":"default"},{"key":"token","value":"","enabled":true,"type":"secret"},{"key":"patient_email","value":"astra+patient@mdintegrations.com","enabled":true,"type":"default"},{"key":"patient_code","value":"4Z0GCQ","enabled":true,"type":"default"},{"key":"patient_access_token","value":"","enabled":true,"type":"default"},{"key":"clinician_email","value":"astra+clinician@mdintegrations.com","enabled":true,"type":"default"},{"key":"clinician_password","value":"@Astra2025","enabled":true,"type":"default"},{"key":"clinician_code","value":"161378","enabled":true,"type":"default"},{"key":"clinician_token","value":"","enabled":true,"type":"default"},{"key":"clinician_access_token","value":"","enabled":true,"type":"default"},{"key":"clinician_refresh_token","value":"","enabled":true,"type":"default"},{"key":"partner_client_id","value":"32013f44-60ce-4fdc-9d58-ea0dc5f82398","enabled":true,"type":"default"},{"key":"partner_client_secret","value":"icTI6HAtgfxVQZbq1FzCOpdAas8NPDwJ7honzPo4","enabled":true,"type":"default"},{"key":"partner_access_token","value":"","enabled":true,"type":"any"},{"key":"panel_user_email","value":"cris+astra+panel+user@mdintegrations.com","enabled":true,"type":"default"},{"key":"panel_user_password","value":"I4o/K+r4=P6N","enabled":true,"type":"default"},{"key":"panel_user_code","value":"2TGR4M","enabled":true,"type":"default"},{"key":"panel_user_access_token","value":"","enabled":true,"type":"any"},{"key":"patient_id","value":"3fee07de-e102-43c3-bfbd-14a4bb6598d9","enabled":true,"type":"default"},{"key":"partner_id","value":"3931b280-a7d4-42dc-89e3-2ea6a1285ee1","enabled":true,"type":"default"},{"key":"intro_video_id","value":"00a7ab2f-f684-41d2-958e-13ff0d3ca1e1","enabled":true,"type":"default"},{"key":"partner_compound_id","value":"8e3b1f92-eaad-4caf-9e6e-e76e3226cbc8","enabled":true,"type":"default"},{"key":"message_id","value":"d6f91e56-ddc9-47f2-afa7-8a516c4ea45b","enabled":true,"type":"default"},{"key":"pharmacy_id","value":"294","enabled":true,"type":"default"},{"key":"preferred_pharmacy_id","value":"","enabled":true,"type":"default"},{"key":"exam_id","value":"ee50dc79-83cf-4aef-a984-30d95e8c8968","enabled":true,"type":"default"},{"key":"dispensable_drug_id","value":"","enabled":true,"type":"default"},{"key":"file_id","value":"e89f647a-f366-4768-8a9a-4c8ac4f37fcb","enabled":true,"type":"default"},{"key":"dispense_unit_id","value":"208583c0-2480-4d7b-857e-57aede6f9091","enabled":true,"type":"default"},{"key":"partner_questionnaire_id","value":"9d28c118-6b7a-4d78-adb0-0638d8cb1624","enabled":true,"type":"default"},{"key":"voucher_id","value":"3bbb8adc-ceec-4efe-a5fe-da6769ae8768","enabled":true,"type":"default"},{"key":"partner_service_id","value":"dc50401c-99fa-4b77-b5d3-55fcca7d62f5","enabled":true,"type":"default"},{"key":"partner_questionnaire_question_id","value":"c3c580e2-f22b-45fe-82e1-e5a8bab7432a","enabled":true,"type":"any"},{"key":"clinician_id","value":"9a5f16c6-6aff-4564-afe6-8de42707a60f","enabled":true,"type":"default"},{"key":"partner_notification_id","value":"06fcbb88-4c6c-419b-9fa6-962cb4866725","enabled":true,"type":"default"},{"key":"case_id","value":"9ed30496-14cb-4cb2-b38e-456fad571c6b","enabled":true,"type":"default"},{"key":"tag_id","value":"87aff3ed-4cd6-4177-81fb-897dadc2b9ba","enabled":true},{"key":"disease_id","value":"e93cae64-633e-40bb-b3f5-55b3aa7a0e8c","enabled":true,"type":"default"},{"key":"case_question_id","value":"","enabled":true,"type":"default"},{"key":"case_service_id","value":"ff6bd938-c6b7-4ec4-9806-c33b773a4cde","enabled":true,"type":"any"},{"key":"dosespot_medication_id","value":"","enabled":true,"type":"any"},{"key":"city_id","value":"a762f0db-ad7c-456a-abc9-0dd52a050387","enabled":true,"type":"default"},{"key":"state_id","value":"cb6e63c5-77dc-4c38-b2db-f07a1e530fe1","enabled":true,"type":"any"},{"key":"patient_voucher_id","value":"3bbb8adc-ceec-4efe-a5fe-da6769ae8768","enabled":true,"type":"default"},{"key":"article_id","value":"a74fc841-cd74-4e80-a73a-a213d3467bf0","enabled":true,"type":"default"},{"key":"patient_message_id","value":"f2c61b79-a251-468d-8961-9f5435d8dc5a","enabled":true,"type":"any"},{"key":"vouched_id","value":"bfc647ed-df26-48fd-b774-186d911367d7","enabled":true,"type":"any"},{"key":"environment_id","value":"da4083f5-436b-491e-9bc1-73507061cd01","enabled":true,"type":"default"},{"key":"clinician_voucher_id","value":"f6ba3868-3d07-4c1d-a36e-96863d23663f","enabled":true,"type":"default"},{"key":"clinician_predefined_message_id","value":"ec19417d-8f23-4419-95e5-680239967050","enabled":true,"type":"default"},{"key":"ticket_id","value":"3b79d0ca-d2f1-4ab8-b905-acfc50cbdcb9","enabled":true,"type":"default"},{"key":"license_id","value":"9a5f16c6-6aff-4564-afe6-8de42707a60f","enabled":true,"type":"default"},{"key":"panel_user_id","value":"a42248df-da93-4e39-82a8-4da2e5c5ce56","enabled":true,"type":"any"},{"key":"supply_id","value":"","enabled":true,"type":"any"},{"key":"category_id","value":"8479c5e5-8bfe-40a0-ad77-622d3e364546","enabled":true,"type":"any"},{"key":"country_id","value":"d7d9273e-16a8-4e8c-b44c-7a0c7f0cb8d8","enabled":true,"type":"any"},{"key":"support_staff_id","value":"e7c94a32-0218-45d9-96d8-cd2d81d40bc7","enabled":true,"type":"any"},{"key":"timezone_id","value":"9ad6ab14-8e5c-41b9-ba29-4135b747c3ed","enabled":true,"type":"any"},{"key":"web_partner_compound_id","value":"eaa2208c-7251-40f5-a3f7-d2dcefcfa3f1","enabled":true,"type":"any"},{"key":"contact_id","value":"983933e9-6464-4291-97b3-45e37c6db5a3","enabled":true,"type":"any"},{"key":"credential_id","value":"fff6118f-52f5-4912-bc1e-909f8ac0c5cc","enabled":true,"type":"any"},{"key":"documentation_id","value":"adf902c7-5a4c-403c-a6a1-2441dccb3484","enabled":true,"type":"any"},{"key":"web_environment_id","value":"9d63a39d-527b-4072-a5a3-6832fc9a6324","enabled":true,"type":"any"},{"key":"partner_medication_id","value":"b48367ca-97b8-45ff-8214-5cec587d39cc","enabled":true,"type":"any"},{"key":"web_partner_medication_id","value":"5cdc1a88-8220-42ec-b0e3-6a4b79ebbbfc","enabled":true,"type":"any"},{"key":"parameter_id","value":"d77bbc00-87cf-4ca5-bb50-9467ddf54551","enabled":true,"type":"any"},{"key":"web_supply_id","value":"d01ef59c-9be0-4616-99b6-c9d2ebf88e36","enabled":true,"type":"any"},{"key":"web_partner_service_id","value":"a4f6c2da-ec10-4cbb-adcd-fd335731bf14","enabled":true,"type":"any"},{"key":"offering_id","value":"49c053b9-6607-4f55-b1fb-e4a178c9def3","enabled":true,"type":"any"},{"key":"partner_offering_id","value":"c091da22-072c-4c11-baa9-efc7463e1e77","enabled":true,"type":"any"},{"key":"rule_id","value":"2f547f6b-ef56-4637-941e-f0a37705a2d9","enabled":true,"type":"any"},{"key":"requirement_id","value":"6031f84a-cd3d-479e-b319-cd374d8f9c2d","enabled":true,"type":"any"},{"key":"web_voucher_id","value":"8a9d8a0c-c6b0-4782-969b-cb749f3150aa","enabled":true,"type":"any"},{"key":"webhook_id","value":"ebce0f74-3673-4cbe-96c4-85e7c505601b","enabled":true,"type":"any"},{"key":"option_id","value":"ebce0f74-3673-4cbe-96c4-85e7c505601b","enabled":true,"type":"any"},{"key":"prescription_id","value":"","enabled":true,"type":"any"},{"key":"case_prescription_id","value":"ed655051-db46-4147-b7b4-6a1430797a42","enabled":true,"type":"any"},{"key":"encounter_id","value":"","enabled":true,"type":"any"},{"key":"shopify_url_store","value":"mdintegrations-cris.myshopify.com","enabled":true,"type":"default"},{"key":"shopify_code","value":"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","enabled":true,"type":"default"},{"key":"shopify_product_id","value":"","enabled":true,"type":"default"},{"key":"shopify_variant_id","value":"","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://postman-image-service.postman.com/api/cloudinary-proxy/postman/image/upload/t_team_logo_pubdoc/v1/team/938b0f895bf4327d4c24896ec338206dab29821ccd588d359bb5b53901d90ba1","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Development","value":"14212272-081b19c4-31dc-4247-bffd-1bde325108a9"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sB3BKGUAk"}