Supplements

Get all supplements

Please note: All dates listed are listed in UTC, so you’ll want to adjust for your local timezone. Also, the API responses include some routes that may not be available for your instance. Supplements can also be accessed through the /alternate_plans/ endpoints, but because most clinics handle supplements separately you will want to use the /supplements/ endpoints unless you’re actively managing other products. Also, these endpoints pertain only to supplement definitions - if you’re looking for patient-associated prescriptions for supplements (including prescribing details) please use the /patients/:pt_id/supplements endpoints.

Also note that while you have full usage rights over any supplement that was created/defined by your practice, and data sets that were installed or provided by a third party are subject to usage restrictions

get/supplements

Request

  • Base URL: https://clinic-subdomain.md-hq.com/api/v1
  • URL: https://clinic-subdomain.md-hq.com/api/v1/supplements
  • Auth: HTTP basic

Query parameters

limitinteger

Defaults to 100, but can be overridden (max is 100)

offsetinteger

If the returned data indicates that there is more than the limit responses (has_more: true), then it will offset the list to allow you to cycle through long supplement list

active_onlyboolean

If this parameter is set it will only include ACTIVE supplements

vendor_codestring

If this parameter is set it will only supplements with matching vendor code (note, this is different from the external_ref_id).

classstring

If this parameter is set it will only supplements with that class specified

external_ref_idstring

If this parameter is set it will only include items with the designated external identifier - generally you will want to make this unique so it only includes a single item.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.