August Health Medication Orders (v1) API

openapi: 3.2.0
info:
  title: August Health Integrations Medication Orders (v1) API
  version: '1.0'
servers:
- url: https://integrations.staging.augusthealth.com
security:
- BearerAuth: []
tags:
- name: Medication Orders (v1)
paths:
  /v1/organizations/{orgId}/facilities/{facilityId}/medicationOrders:
    get:
      description: Returns a paginated list of all medication orders for all residents at a facility. Results are sorted by order ID (ascending).
      operationId: listFacilityMedicationOrdersV1
      parameters:
      - in: path
        name: orgId
        required: true
        schema:
          type: string
      - in: path
        name: facilityId
        required: true
        schema:
          type: string
      - description: Filter for medication orders updated on or after this timestamp (ISO 8601 format with timezone)
        in: query
        name: updatedAfter
        required: false
        schema:
          example: '2024-01-15T10:30:00Z'
          format: date-time
          type: string
      - description: Maximum number of results to return (default 1000, max 5000)
        in: query
        name: limit
        required: false
        schema:
          default: 1000
          format: int32
          maximum: 5000
          type: integer
      - description: Number of results to skip (default 0)
        in: query
        name: offset
        required: false
        schema:
          default: 0
          format: int32
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.MedicationOrder'
                    type: array
                  meta:
                    $ref: '#/components/schemas/com.august.api.integrations.models.common.ApiResponseMetadata'
                type: object
          description: Successfully retrieved medication orders.
        '400':
          description: Invalid request parameters
        '401':
          description: Authentication required
        '403':
          description: User lacks permission to read medication orders at this facility
      summary: List all medication orders for all residents of a facility
      tags:
      - Medication Orders (v1)
  /v1/organizations/{orgId}/facilities/{facilityId}/people/{personId}/medicationOrders:
    get:
      description: Returns a paginated list of all medication orders for a specific person. Results are sorted by order ID (ascending).
      operationId: listPersonMedicationOrdersV1
      parameters:
      - in: path
        name: orgId
        required: true
        schema:
          type: string
      - in: path
        name: facilityId
        required: true
        schema:
          type: string
      - in: path
        name: personId
        required: true
        schema:
          type: string
      - description: Filter for medication orders updated on or after this timestamp (ISO 8601 format with timezone)
        in: query
        name: updatedAfter
        required: false
        schema:
          example: '2024-01-15T10:30:00Z'
          format: date-time
          type: string
      - description: Maximum number of results to return (default 1000, max 5000)
        in: query
        name: limit
        required: false
        schema:
          default: 1000
          format: int32
          maximum: 5000
          type: integer
      - description: Number of results to skip (default 0)
        in: query
        name: offset
        required: false
        schema:
          default: 0
          format: int32
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.MedicationOrder'
                    type: array
                  meta:
                    $ref: '#/components/schemas/com.august.api.integrations.models.common.ApiResponseMetadata'
                type: object
          description: Successfully retrieved medication orders.
        '400':
          description: Invalid request parameters
        '401':
          description: Authentication required
        '403':
          description: User lacks permission to read medication orders for this person
        '404':
          description: Person not found
      summary: List all medication orders for a person
      tags:
      - Medication Orders (v1)
components:
  schemas:
    com.august.api.integrations.models.common.ApiResponseMetadata:
      properties:
        limit:
          description: The limit used for a paginated request for the query
          format: int32
          type: integer
        offset:
          description: The offset used for a paginated request for the query
          format: int32
          type: integer
        total:
          description: The total number of available items for the query
          format: int32
          type: integer
      required:
      - total
      - limit
      - offset
    com.august.api.integrations.models.medication_orders.v1.MedicationOrderStatus:
      enum:
      - ACTIVE
      - FUTURE
      - ON_HOLD
      - DISCONTINUED
      type: string
    com.august.api.integrations.models.medication_orders.v1.TimeOfDay:
      properties:
        time:
          $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.TimeOfDay.TimeParts'
          description: The exact time (hour and minute)
        when:
          $ref: '#/components/schemas/com.august.protos.timing.EventTiming'
          description: A named timing event (e.g., morning, evening, before meals)
    com.august.api.integrations.models.medication_orders.v1.Medication:
      properties:
        code:
          $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.CodeableConcept'
          description: Codeable concept identifying this medication (e.g., NDC, RxNorm)
        drugName:
          description: The name of the drug
          type: string
        medicationClass:
          description: The therapeutic classification(s) of this medication
          items:
            $ref: '#/components/schemas/com.august.protos.medication.MedicationClass'
            description: The therapeutic classification(s) of this medication
          type: array
        schedule:
          description: The DEA controlled substance schedule, if applicable
          type: string
        strengthAndForm:
          description: The drug's strength and form (e.g., "500mg tablet")
          type: string
      required:
      - drugName
      - code
    com.august.api.integrations.models.medication_orders.v1.Coding:
      properties:
        code:
          description: The code value within the system
          type: string
        display:
          description: Human-readable description of the code
          type: string
        system:
          $ref: '#/components/schemas/com.august.protos.codeable_concept.SystemUrl'
          description: The coding system (e.g., RXNORM, NDC, SNOMED_CT)
      required:
      - system
      - code
      - display
    com.august.api.integrations.models.medication_orders.v1.DoseAndRate:
      properties:
        doseQuantity:
          $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.SimpleQuantity'
          description: The amount to administer (value and unit)
    com.august.protos.timing.UnitOfTime:
      enum:
      - UNIT_OF_TIME_SECOND
      - UNIT_OF_TIME_MINUTE
      - UNIT_OF_TIME_HOUR
      - UNIT_OF_TIME_DAY
      - UNIT_OF_TIME_WEEK
      - UNIT_OF_TIME_MONTH
      - UNIT_OF_TIME_YEAR
      type: string
    com.august.api.integrations.models.medication_orders.v1.MedicationOrder:
      properties:
        additionalInstructions:
          description: Additional administration instructions (e.g., take with food)
          items:
            $ref: '#/components/schemas/com.august.protos.medication_statement.AdditionalInstructions'
            description: Additional administration instructions (e.g., take with food)
          type: array
        approvedAt:
          description: When the order was approved by a physician
          format: date-time
          type: string
        discontinuedAt:
          description: When the order was discontinued, if applicable
          format: date-time
          type: string
        dosageInstruction:
          description: Structured dosage and timing instructions
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.DosageInstruction'
            description: Structured dosage and timing instructions
          type: array
        dosageType:
          $ref: '#/components/schemas/com.august.protos.medication_statement.DosageType'
          description: The type of dosage (e.g., scheduled, PRN)
        effectivePeriod:
          $ref: '#/components/schemas/com.august.api.integrations.models.common.date.DateTimePeriod'
          description: When this order starts and ends. Times are in the facility's local time zone
        id:
          description: The medication order's ID
          type: string
        isOutsideProviderAdministered:
          description: Whether an outside provider administers this medication
          type: boolean
        isTreatment:
          description: Whether this order is a treatment (as opposed to a standing medication)
          type: boolean
        medication:
          $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.Medication'
          description: Drug information including name, strength, and coding identifiers
        note:
          description: Free-text notes about this order
          type: string
        orderGroupId:
          description: Groups related orders together (e.g., original and renewal)
          type: string
        personId:
          description: The resident this order belongs to
          type: string
        pharmacy:
          description: Name of the dispensing pharmacy
          type: string
        prescriber:
          description: Name of the prescribing physician
          type: string
        providerDosageInstructions:
          description: Free-text dosage instructions from the provider
          type: string
        requiredVitals:
          description: Vitals that must be recorded before administering this medication
          items:
            $ref: '#/components/schemas/com.august.protos.vital.VitalType'
            description: Vitals that must be recorded before administering this medication
          type: array
        requiresControlledCount:
          description: Whether this medication requires a controlled substance count
          type: boolean
        rxNumber:
          description: The prescription number assigned by the pharmacy
          type: string
        selfAdministered:
          description: Whether the resident self-administers this medication
          type: boolean
        status:
          $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.MedicationOrderStatus'
          description: Computed status based on the effective period and hold periods
      required:
      - id
      - personId
      - orderGroupId
      - status
      - requiresControlledCount
      - selfAdministered
      - isOutsideProviderAdministered
      - isTreatment
      - dosageType
    com.august.protos.timing.DayOfWeek:
      enum:
      - DAY_OF_WEEK_MONDAY
      - DAY_OF_WEEK_TUESDAY
      - DAY_OF_WEEK_WEDNESDAY
      - DAY_OF_WEEK_THURSDAY
      - DAY_OF_WEEK_FRIDAY
      - DAY_OF_WEEK_SATURDAY
      - DAY_OF_WEEK_SUNDAY
      type: string
    com.august.api.integrations.models.medication_orders.v1.TimeOfDay.TimeParts:
      properties:
        hour:
          format: int32
          type: integer
        minute:
          format: int32
          type: integer
      required:
      - hour
      - minute
    com.august.api.integrations.models.medication_orders.v1.SimpleQuantity:
      properties:
        unit:
          description: The unit of measurement (e.g., "mg", "mL", "tablet")
          type: string
        value:
          description: The numeric value of the quantity
          format: double
          type: number
    com.august.api.integrations.models.common.date.DateTimePeriod:
      properties:
        endDate:
          example: '2020-01-01'
          format: date
          type: string
        endTime:
          example: '15:30:00'
          format: time-local
          type: string
        startDate:
          example: '2020-01-01'
          format: date
          type: string
        startTime:
          example: '15:30:00'
          format: time-local
          type: string
    com.august.api.integrations.models.medication_orders.v1.DosageInstruction:
      properties:
        asNeededBoolean:
          description: Whether this medication is administered as needed (PRN)
          type: boolean
        doseAndRate:
          $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.DoseAndRate'
          description: The dose quantity for each administration
        route:
          description: The route of administration (e.g., "oral", "topical")
          type: string
        site:
          description: The body site for administration (e.g., "left arm")
          type: string
        text:
          description: Human-readable dosage instructions
          type: string
        timing:
          $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.TimingInfo'
          description: When the medication should be administered
      required:
      - asNeededBoolean
    com.august.protos.medication_statement.DosageType:
      enum:
      - DOSAGE_TYPE_ROUTINE
      - DOSAGE_TYPE_PRN
      - DOSAGE_TYPE_SPLIT
      - DOSAGE_TYPE_TAPER
      - DOSAGE_TYPE_SLIDING_SCALE
      - DOSAGE_TYPE_VITAL
      type: string
    com.august.protos.medication_statement.AdditionalInstructions:
      enum:
      - ADDITIONAL_INSTRUCTIONS_BEFORE_MEALS
      - ADDITIONAL_INSTRUCTIONS_AFTER_MEALS
      type: string
    com.august.protos.timing.EventTiming:
      enum:
      - EVENT_TIMING_MORN
      - EVENT_TIMING_AFT
      - EVENT_TIMING_EVE
      - EVENT_TIMING_NIGHT
      type: string
    com.august.api.integrations.models.medication_orders.v1.CodeableConcept:
      properties:
        coding:
          description: Structured identifiers from coding systems (e.g., NDC, RxNorm, SNOMED CT)
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.Coding'
            description: Structured identifiers from coding systems (e.g., NDC, RxNorm, SNOMED CT)
          type: array
        text:
          description: Human-readable display name
          type: string
      required:
      - coding
      - text
    com.august.protos.vital.VitalType:
      enum:
      - VITAL_TYPE_WEIGHT
      - VITAL_TYPE_TEMPERATURE
      - VITAL_TYPE_BLOOD_PRESSURE
      - VITAL_TYPE_HEART_RATE
      - VITAL_TYPE_RESPIRATORY_RATE
      - VITAL_TYPE_BLOOD_SUGAR
      - VITAL_TYPE_OXYGEN_SATURATION
      - VITAL_TYPE_PAIN
      - VITAL_TYPE_HEIGHT
      type: string
    com.august.protos.codeable_concept.SystemUrl:
      enum:
      - SYSTEM_URL_RXNORM
      - SYSTEM_URL_SNOMED_CT
      - SYSTEM_URL_NDC
      - SYSTEM_URL_ICD_10
      - SYSTEM_URL_DEA
      - SYSTEM_URL_EDQM
      - SYSTEM_URL_GPI
      - SYSTEM_URL_NPI
      - SYSTEM_URL_UPC
      type: string
    com.august.api.integrations.models.medication_orders.v1.TimingInfo:
      properties:
        dayOfMonth:
          description: Which days of the month to administer
          items:
            description: Which days of the month to administer
            format: int32
            type: integer
          type: array
        dayOfWeek:
          description: Which days of the week to administer
          items:
            $ref: '#/components/schemas/com.august.protos.timing.DayOfWeek'
            description: Which days of the week to administer
          type: array
        frequency:
          description: How many administrations occur within each period
          format: int32
          type: integer
        oneTimeOnly:
          description: Whether this is a one-time administration
          type: boolean
        period:
          description: How many periodUnits each period spans
          format: int32
          type: integer
        periodUnit:
          $ref: '#/components/schemas/com.august.protos.timing.UnitOfTime'
          description: The unit the period is measured in
        timeOfDay:
          description: Specific times of day for administration
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.medication_orders.v1.TimeOfDay'
            description: Specific times of day for administration
          type: array
      required:
      - timeOfDay
      - dayOfWeek
      - dayOfMonth
      - oneTimeOnly
    com.august.protos.medication.MedicationClass:
      enum:
      - MEDICATION_CLASS_NARCOTIC
      - MEDICATION_CLASS_PSYCHOTROPIC
      type: string
  securitySchemes:
    BearerAuth:
      scheme: bearer
      type: http
x-provenance:
  method: searched
  source: https://developer.augusthealth.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developer.augusthealth.com/reference/bulkchartroutineadministrationsv1.md
  - https://developer.augusthealth.com/reference/createcontactv1-1.md
  - https://developer.augusthealth.com/reference/createincidentv1.md
  - https://developer.augusthealth.com/reference/createpersonv1-1.md
  - https://developer.augusthealth.com/reference/createresidentbiographyv1.md
  - https://developer.augusthealth.com/reference/createtokenv1.md
  - https://developer.augusthealth.com/reference/createvisitorlogv1.md
  - https://developer.augusthealth.com/reference/createvitalv1.md
  - https://developer.augusthealth.com/reference/createwebhooksportalaccessurlv1.md
  - https://developer.augusthealth.com/reference/deletevisitorlogv1.md
  - https://developer.augusthealth.com/reference/extractresidentbiographyv1.md
  - https://developer.augusthealth.com/reference/getadmissionagreementpdfv1.md
  - https://developer.augusthealth.com/reference/getadmissionagreementv1.md
  - https://developer.augusthealth.com/reference/getadmissionhistoryv1.md
  - https://developer.augusthealth.com/reference/getassessmentv1.md
  - https://developer.augusthealth.com/reference/getbillingsummaryv1.md
  - https://developer.augusthealth.com/reference/getcensuspersonv1.md
  - https://developer.augusthealth.com/reference/getcontactv1-1.md
  - https://developer.augusthealth.com/reference/getfacilityadmissionhistoryv1.md
  - https://developer.augusthealth.com/reference/getfacilitybedassignmenthistoryv1.md
  - https://developer.augusthealth.com/reference/getimmunizationv1.md
  - https://developer.augusthealth.com/reference/getincidentv1.md
  - https://developer.augusthealth.com/reference/getlatestadmissionagreementv1.md
  - https://developer.augusthealth.com/reference/getlatestassessmentv1.md
  - https://developer.augusthealth.com/reference/getlatestresidentbiographyv1.md
  - https://developer.augusthealth.com/reference/getpersonprofilephotov1.md
  - https://developer.augusthealth.com/reference/getpersonv1-1.md
  - https://developer.augusthealth.com/reference/getstatementpdfv1.md
  - https://developer.augusthealth.com/reference/getvitalv1.md
  - https://developer.augusthealth.com/reference/listbedassignmentsv1.md
  - https://developer.augusthealth.com/reference/listcensusv1.md
  - https://developer.augusthealth.com/reference/listcontactsv1-1.md
  - https://developer.augusthealth.com/reference/listfacilitiesv1-1.md
  - https://developer.augusthealth.com/reference/listfacilitybillingsummariesv1.md
  - https://developer.augusthealth.com/reference/listfacilityincidentsv1.md
  - https://developer.augusthealth.com/reference/listfacilitymedicationadministrationsv1.md
  - https://developer.augusthealth.com/reference/listfacilitymedicationordersv1.md
  - https://developer.augusthealth.com/reference/listfacilityroutineadministrationsv1.md
  - https://developer.augusthealth.com/reference/listimmunizationsv1.md
  - https://developer.augusthealth.com/reference/listmedpassesv1.md
  - https://developer.augusthealth.com/reference/listorganizationsv1.md
  - https://developer.augusthealth.com/reference/listpeoplev1-1.md
  - https://developer.augusthealth.com/reference/listpersonincidentsv1.md
  - https://developer.augusthealth.com/reference/listpersonmedicationadministrationsv1.md
  - https://developer.augusthealth.com/reference/listpersonmedicationordersv1.md
  - https://developer.augusthealth.com/reference/listprncarecategoriesv1.md
  - https://developer.augusthealth.com/reference/listresidentbillingtransactionsv1.md
  - https://developer.augusthealth.com/reference/listroomsv1.md
  - https://developer.augusthealth.com/reference/listroutineadministrationsv1.md
  - https://developer.augusthealth.com/reference/listshiftsv1.md
  - https://developer.augusthealth.com/reference/listtasksv1.md
  - https://developer.augusthealth.com/reference/listusersv1.md
  - https://developer.augusthealth.com/reference/listvisitorlogsv1.md
  - https://developer.augusthealth.com/reference/listvitalsv1.md
  - https://developer.augusthealth.com/reference/patchpersonv1.md
  - https://developer.augusthealth.com/reference/recordchargesv1.md
  - https://developer.augusthealth.com/reference/recorddepositv1.md
  - https://developer.augusthealth.com/reference/searchstatementsv1.md
  - https://developer.augusthealth.com/reference/setresponsiblepersonv1-1.md
  - https://developer.augusthealth.com/reference/updateincidentv1.md
  - https://developer.augusthealth.com/reference/updatevitalv1.md
  merge:
    pages: 61
    deduped: 634
    conflicts_kept_first: 0