openapi: 3.0.0 info: title: 'OpenEMR API' version: 7.0.0 servers: - url: /apis/default/ paths: /api/facility: get: tags: - standard description: 'Returns a single facility.' parameters: - name: name in: query description: 'The name for the facility.' required: false schema: type: string - name: facility_npi in: query description: 'The facility_npi for the facility.' required: false schema: type: string - name: phone in: query description: 'The phone for the facility.' required: false schema: type: string - name: fax in: query description: 'The fax for the facility.' required: false schema: type: string - name: street in: query description: 'The street for the facility.' required: false schema: type: string - name: city in: query description: 'The city for the facility.' required: false schema: type: string - name: state in: query description: 'The state for the facility.' required: false schema: type: string - name: postal_code in: query description: 'The postal_code for the facility.' required: false schema: type: string - name: country_code in: query description: 'The country_code for the facility.' required: false schema: type: string - name: federal_ein in: query description: 'The federal_ein for the facility.' required: false schema: type: string - name: website in: query description: 'The website for the facility.' required: false schema: type: string - name: email in: query description: 'The email for the facility.' required: false schema: type: string - name: domain_identifier in: query description: 'The domain_identifier for the facility.' required: false schema: type: string - name: facility_taxonomy in: query description: 'The facility_taxonomy for the facility.' required: false schema: type: string - name: facility_code in: query description: 'The facility_code for the facility.' required: false schema: type: string - name: billing_location in: query description: 'The billing_location setting for the facility.' required: false schema: type: string - name: accepts_assignment in: query description: 'The accepts_assignment setting for the facility.' required: false schema: type: string - name: oid in: query description: 'The oid for the facility.' required: false schema: type: string - name: service_location in: query description: 'The service_location setting for the facility.' required: false schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Creates a facility in the system' requestBody: required: true content: application/json: schema: required: - name - facility_npi properties: name: description: 'The name for the facility.' type: string facility_npi: description: 'The facility_npi for the facility.' type: string phone: description: 'The phone for the facility.' type: string fax: description: 'The fax for the facility.' type: string street: description: 'The street for the facility.' type: string city: description: 'The city for the facility.' type: string state: description: 'The state for the facility.' type: string postal_code: description: 'The postal_code for the facility.' type: string country_code: description: 'The country_code for the facility.' type: string federal_ein: description: 'The federal_ein for the facility.' type: string website: description: 'The website for the facility.' type: string email: description: 'The email for the facility.' type: string domain_identifier: description: 'The domain_identifier for the facility.' type: string facility_taxonomy: description: 'The facility_taxonomy for the facility.' type: string facility_code: description: 'The facility_code for the facility.' type: string billing_location: description: 'The billing_location setting for the facility.' type: string accepts_assignment: description: 'The accepts_assignment setting for the facility.' type: string oid: description: 'The oid for the facility.' type: string service_location: description: 'The service_location setting for the facility.' type: string type: object example: name: Aquaria facility_npi: '123456789123' phone: 808-606-3030 fax: 808-606-3031 street: '1337 Bit Shifter Ln' city: 'San Lorenzo' state: ZZ postal_code: '54321' country_code: US federal_ein: '4343434' website: 'https://example.com' email: foo@bar.com domain_identifier: '' facility_taxonomy: '' facility_code: '' billing_location: '1' accepts_assignment: '1' oid: '' service_location: '1' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/facility/{fuuid}': get: tags: - standard description: 'Returns a single facility.' parameters: - name: fuuid in: path description: 'The uuid for the facility.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Updates a facility in the system' parameters: - name: fuuid in: path description: 'The uuid for the facility.' required: true schema: type: string requestBody: required: true content: application/json: schema: properties: name: description: 'The name for the facility.' type: string facility_npi: description: 'The facility_npi for the facility.' type: string phone: description: 'The phone for the facility.' type: string fax: description: 'The fax for the facility.' type: string street: description: 'The street for the facility.' type: string city: description: 'The city for the facility.' type: string state: description: 'The state for the facility.' type: string postal_code: description: 'The postal_code for the facility.' type: string country_code: description: 'The country_code for the facility.' type: string federal_ein: description: 'The federal_ein for the facility.' type: string website: description: 'The website for the facility.' type: string email: description: 'The email for the facility.' type: string domain_identifier: description: 'The domain_identifier for the facility.' type: string facility_taxonomy: description: 'The facility_taxonomy for the facility.' type: string facility_code: description: 'The facility_code for the facility.' type: string billing_location: description: 'The billing_location setting for the facility.' type: string accepts_assignment: description: 'The accepts_assignment setting for the facility.' type: string oid: description: 'The oid for the facility.' type: string service_location: description: 'The service_location setting for the facility.' type: string type: object example: name: Aquaria facility_npi: '123456789123' phone: 808-606-3030 fax: 808-606-3031 street: '1337 Bit Shifter Ln' city: 'San Lorenzo' state: ZZ postal_code: '54321' country_code: US federal_ein: '4343434' website: 'https://example.com' email: foo@bar.com domain_identifier: '' facility_taxonomy: '' facility_code: '' billing_location: '1' accepts_assignment: '1' oid: '' service_location: '1' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/patient: get: tags: - standard description: 'Retrieves a list of patients' parameters: - name: fname in: query description: 'The first name for the patient.' required: false schema: type: string - name: lname in: query description: 'The last name for the patient.' required: false schema: type: string - name: ss in: query description: 'The social security number for the patient.' required: false schema: type: string - name: street in: query description: 'The street for the patient.' required: false schema: type: string - name: postal_code in: query description: 'The postal code for the patient.' required: false schema: type: string - name: city in: query description: 'The city for the patient.' required: false schema: type: string - name: state in: query description: 'The state for the patient.' required: false schema: type: string - name: phone_home in: query description: 'The home phone for the patient.' required: false schema: type: string - name: phone_biz in: query description: 'The business phone for the patient.' required: false schema: type: string - name: phone_cell in: query description: 'The cell phone for the patient.' required: false schema: type: string - name: postal_contact in: query description: 'The postal_contact for the patient.' required: false schema: type: string - name: sex in: query description: 'The gender for the patient.' required: false schema: type: string - name: country_code in: query description: 'The country code for the patient.' required: false schema: type: string - name: email in: query description: 'The email for the patient.' required: false schema: type: string - name: DOB in: query description: 'The DOB for the patient.' required: false schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Creates a new patient' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_patient_request' responses: '200': description: 'Standard response' content: application/json: schema: properties: validationErrors: { description: 'Validation errors.', type: array, items: { type: object } } internalErrors: { description: 'Internal errors.', type: array, items: { type: object } } data: { description: 'Returned data.', type: array, items: { properties: { pid: { description: 'patient pid', type: integer } }, type: object } } type: object example: validationErrors: [] error_description: [] data: { pid: 1 } '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{puuid}': get: tags: - standard description: 'Retrieves a single patient by their uuid' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string responses: '200': description: 'Standard response' content: application/json: schema: $ref: '#/components/schemas/api_patient_response' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Updates a patient' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_patient_request' responses: '200': description: 'Standard response' content: application/json: schema: $ref: '#/components/schemas/api_patient_response' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{puuid}/encounter': get: tags: - standard description: 'Retrieves a list of encounters for a single patient' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Creates a new encounter' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_encounter_request' responses: '200': description: 'Standard response' content: application/json: schema: properties: validationErrors: { description: 'Validation errors.', type: array, items: { type: object } } internalErrors: { description: 'Internal errors.', type: array, items: { type: object } } data: { description: 'Returned data.', type: array, items: { properties: { encounter: { description: 'encounter id', type: integer }, uuid: { description: 'encounter uuid', type: string } }, type: object } } type: object example: validationErrors: [] error_description: [] data: { encounter: 1, uuid: 90c196f2-51cc-4655-8858-3a80aebff3ef } '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{puuid}/encounter/{euuid}': get: tags: - standard description: 'Retrieves a single encounter for a patient' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string - name: euuid in: path description: 'The uuid for the encounter.' required: true schema: type: string responses: '200': description: 'Standard response' content: application/json: schema: $ref: '#/components/schemas/api_encounter_response' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Modify a encounter' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string - name: euuid in: path description: 'The uuid for the encounter.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_encounter_request' responses: '200': description: 'Standard response' content: application/json: schema: $ref: '#/components/schemas/api_encounter_response' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/encounter/{eid}/soap_note': get: tags: - standard description: 'Retrieves soap notes from an encounter for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the encounter.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new soap note' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the encounter.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_soap_note_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/encounter/{eid}/vital': get: tags: - standard description: 'Retrieves all vitals from an encounter for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the encounter.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new vitals form' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the encounter.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_vital_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/encounter/{eid}/vital/{vid}': get: tags: - standard description: 'Retrieves a vitals form from an encounter for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the encounter.' required: true schema: type: string - name: vid in: path description: 'The id for the vitals form.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a vitals form' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the encounter.' required: true schema: type: string - name: vid in: path description: 'The id for the vitalss form.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_vital_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/encounter/{eid}/soap_note/{sid}': get: tags: - standard description: 'Retrieves a soap note from an encounter for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the encounter.' required: true schema: type: string - name: sid in: path description: 'The id for the soap note.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a soap note' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the encounter.' required: true schema: type: string - name: sid in: path description: 'The id for the soap noted.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_soap_note_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/practitioner: get: tags: - standard description: 'Retrieves a list of practitioners' parameters: - name: title in: query description: 'The title for the practitioner.' required: false schema: type: string - name: fname in: query description: 'The first name for the practitioner.' required: false schema: type: string - name: lname in: query description: 'The last name for the practitioner.' required: false schema: type: string - name: mname in: query description: 'The middle name for the practitioner.' required: false schema: type: string - name: federaltaxid in: query description: 'The federal tax id for the practitioner.' required: false schema: type: string - name: federaldrugid in: query description: 'The federal drug id for the practitioner.' required: false schema: type: string - name: upin in: query description: 'The upin for the practitioner.' required: false schema: type: string - name: facility_id in: query description: 'The facility id for the practitioner.' required: false schema: type: string - name: facility in: query description: 'The facility for the practitioner.' required: false schema: type: string - name: npi in: query description: 'The npi for the practitioner.' required: false schema: type: string - name: email in: query description: 'The email for the practitioner.' required: false schema: type: string - name: specialty in: query description: 'The specialty for the practitioner.' required: false schema: type: string - name: billname in: query description: 'The billname for the practitioner.' required: false schema: type: string - name: url in: query description: 'The url for the practitioner.' required: false schema: type: string - name: assistant in: query description: 'The assistant for the practitioner.' required: false schema: type: string - name: organization in: query description: 'The organization for the practitioner.' required: false schema: type: string - name: valedictory in: query description: 'The valedictory for the practitioner.' required: false schema: type: string - name: street in: query description: 'The street for the practitioner.' required: false schema: type: string - name: streetb in: query description: 'The street (line 2) for the practitioner.' required: false schema: type: string - name: city in: query description: 'The city for the practitioner.' required: false schema: type: string - name: state in: query description: 'The state for the practitioner.' required: false schema: type: string - name: zip in: query description: 'The zip for the practitioner.' required: false schema: type: string - name: phone in: query description: 'The phone for the practitioner.' required: false schema: type: string - name: fax in: query description: 'The fax for the practitioner.' required: false schema: type: string - name: phonew1 in: query description: 'The phonew1 for the practitioner.' required: false schema: type: string - name: phonecell in: query description: 'The phonecell for the practitioner.' required: false schema: type: string - name: notes in: query description: 'The notes for the practitioner.' required: false schema: type: string - name: state_license_number2 in: query description: 'The state license number for the practitioner.' required: false schema: type: string - name: username in: query description: 'The username for the practitioner.' required: false schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new practitioner' requestBody: required: true content: application/json: schema: required: - fname - lname - npi properties: title: description: 'The title for the practitioner.' type: string fname: description: 'The first name for the practitioner.' type: string mname: description: 'The middle name for the practitioner.' type: string lname: description: 'The last name for the practitioner.' type: string federaltaxid: description: 'The federal tax id for the practitioner.' type: string federaldrugid: description: 'The federal drug id for the practitioner.' type: string upin: description: 'The upin for the practitioner.' type: string facility_id: description: 'The facility_id for the practitioner.' type: string facility: description: 'The facility name for the practitioner.' type: string npi: description: 'The npi for the practitioner.' type: string email: description: 'The email for the practitioner.' type: string specialty: description: 'The specialty for the practitioner.' type: string billname: description: 'The billname for the practitioner.' type: string url: description: 'The url for the practitioner.' type: string assistant: description: 'The assistant for the practitioner.' type: string valedictory: description: 'The valedictory for the practitioner.' type: string street: description: 'The street address for the practitioner.' type: string streetb: description: 'The streetb address for the practitioner.' type: string city: description: 'The city for the practitioner.' type: string state: description: 'The state for the practitioner.' type: string zip: description: 'The zip for the practitioner.' type: string phone: description: 'The phone for the practitioner.' type: string fax: description: 'The fax for the practitioner.' type: string phonew1: description: 'The phonew1 for the practitioner.' type: string phonecell: description: 'The phonecell for the practitioner.' type: string notes: description: 'The notes for the practitioner.' type: string state_license_number: description: 'The state license number for the practitioner.' type: string username: description: 'The username for the practitioner.' type: string type: object example: title: Mrs. fname: Eduardo mname: Kathy lname: Perez federaltaxid: '' federaldrugid: '' upin: '' facility_id: '3' facility: 'Your Clinic Name Here' npi: '12345678901' email: info@pennfirm.com specialty: '' billname: null url: null assistant: null organization: null valedictory: null street: '789 Third Avenue' streetb: '123 Cannaut Street' city: 'San Diego' state: CA zip: '90210' phone: '(619) 555-9827' fax: null phonew1: '(619) 555-7822' phonecell: '(619) 555-7821' notes: null state_license_number: '123456' username: eduardoperez responses: '200': description: 'Standard response' content: application/json: schema: properties: validationErrors: { description: 'Validation errors.', type: array, items: { type: object } } internalErrors: { description: 'Internal errors.', type: array, items: { type: object } } data: { description: 'Returned data.', type: array, items: { properties: { id: { description: 'practitioner id', type: integer }, uuid: { description: 'practitioner uuid', type: string } }, type: object } } type: object example: validationErrors: [] error_description: [] data: { id: 7, uuid: 90d453fb-0248-4c0d-9575-d99d02b169f5 } '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/practitioner/{pruuid}': get: tags: - standard description: 'Retrieves a single practitioner by their uuid' parameters: - name: pruuid in: path description: 'The uuid for the practitioner.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a practitioner' parameters: - name: pruuid in: path description: 'The uuid for the practitioner.' required: true schema: type: string requestBody: required: true content: application/json: schema: properties: title: description: 'The title for the practitioner.' type: string fname: description: 'The first name for the practitioner.' type: string mname: description: 'The middle name for the practitioner.' type: string lname: description: 'The last name for the practitioner.' type: string federaltaxid: description: 'The federal tax id for the practitioner.' type: string federaldrugid: description: 'The federal drug id for the practitioner.' type: string upin: description: 'The upin for the practitioner.' type: string facility_id: description: 'The facility_id for the practitioner.' type: string facility: description: 'The facility name for the practitioner.' type: string npi: description: 'The npi for the practitioner.' type: string email: description: 'The email for the practitioner.' type: string specialty: description: 'The specialty for the practitioner.' type: string billname: description: 'The billname for the practitioner.' type: string url: description: 'The url for the practitioner.' type: string assistant: description: 'The assistant for the practitioner.' type: string valedictory: description: 'The valedictory for the practitioner.' type: string street: description: 'The street address for the practitioner.' type: string streetb: description: 'The streetb address for the practitioner.' type: string city: description: 'The city for the practitioner.' type: string state: description: 'The state for the practitioner.' type: string zip: description: 'The zip for the practitioner.' type: string phone: description: 'The phone for the practitioner.' type: string fax: description: 'The fax for the practitioner.' type: string phonew1: description: 'The phonew1 for the practitioner.' type: string phonecell: description: 'The phonecell for the practitioner.' type: string notes: description: 'The notes for the practitioner.' type: string state_license_number: description: 'The state license number for the practitioner.' type: string username: description: 'The username for the practitioner.' type: string type: object example: title: Mr fname: Baz mname: '' lname: Bop street: '456 Tree Lane' zip: '08642' city: FooTown state: FL phone: 123-456-7890 responses: '200': description: 'Standard response' content: application/json: schema: properties: validationErrors: { description: 'Validation errors.', type: array, items: { type: object } } internalErrors: { description: 'Internal errors.', type: array, items: { type: object } } data: { description: 'Returned data.', type: array, items: { properties: { id: { description: 'practitioner id', type: string }, uuid: { description: 'practitioner uuid', type: string }, title: { description: 'practitioner title', type: string }, fname: { description: 'practitioner fname', type: string }, lname: { description: 'practitioner lname', type: string }, mname: { description: 'practitioner mname', type: string }, federaltaxid: { description: 'practitioner federaltaxid', type: string }, federaldrugid: { description: 'practitioner federaldrugid', type: string }, upin: { description: 'practitioner upin', type: string }, facility_id: { description: 'practitioner facility_id', type: string }, facility: { description: 'practitioner facility', type: string }, npi: { description: 'practitioner npi', type: string }, email: { description: 'practitioner email', type: string }, active: { description: 'practitioner active setting', type: string }, specialty: { description: 'practitioner specialty', type: string }, billname: { description: 'practitioner billname', type: string }, url: { description: 'practitioner url', type: string }, assistant: { description: 'practitioner assistant', type: string }, organization: { description: 'practitioner organization', type: string }, valedictory: { description: 'practitioner valedictory', type: string }, street: { description: 'practitioner street', type: string }, streetb: { description: 'practitioner streetb', type: string }, city: { description: 'practitioner city', type: string }, state: { description: 'practitioner state', type: string }, zip: { description: 'practitioner zip', type: string }, phone: { description: 'practitioner phone', type: string }, fax: { description: fax, type: string }, phonew1: { description: 'practitioner phonew1', type: string }, phonecell: { description: 'practitioner phonecell', type: string }, notes: { description: 'practitioner notes', type: string }, state_license_number: { description: 'practitioner state license number', type: string }, abook_title: { description: 'practitioner abook title', type: string }, physician_title: { description: 'practitioner physician title', type: string }, physician_code: { description: 'practitioner physician code', type: string } }, type: object } } type: object example: validationErrors: [] error_description: [] data: { id: 7, uuid: 90d453fb-0248-4c0d-9575-d99d02b169f5, title: Mr, fname: Baz, lname: Bop, mname: '', federaltaxid: '', federaldrugid: '', upin: '', facility_id: '3', facility: 'Your Clinic Name Here', npi: '0123456789', email: info@pennfirm.com, active: '1', specialty: '', billname: '', url: '', assistant: '', organization: '', valedictory: '', street: '456 Tree Lane', streetb: '123 Cannaut Street', city: FooTown, state: FL, zip: '08642', phone: 123-456-7890, fax: '', phonew1: '(619) 555-7822', phonecell: '(619) 555-7821', notes: '', state_license_number: '123456', abook_title: null, physician_title: null, physician_code: null } '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/medical_problem: get: tags: - standard description: 'Retrieves a list of medical problems' parameters: - name: puuid in: query description: 'The uuid for the patient.' required: false schema: type: string - name: condition_uuid in: query description: 'The uuid for the medical problem.' required: false schema: type: string - name: title in: query description: 'The title for the medical problem.' required: false schema: type: string - name: begdate in: query description: 'The start date for the medical problem.' required: false schema: type: string - name: enddate in: query description: 'The end date for the medical problem.' required: false schema: type: string - name: diagnosis in: query description: 'The diagnosis for the medical problem.' required: false schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/medical_problem/{muuid}': get: tags: - standard description: 'Retrieves a single medical problem by their uuid' parameters: - name: muuid in: path description: 'The uuid for the medical problem.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{puuid}/medical_problem': get: tags: - standard description: 'Retrieves all medical problems for a patient' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new medical problem' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_medical_problem_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{puuid}/medical_problem/{muuid}': get: tags: - standard description: 'Retrieves a medical problem for a patient' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string - name: muuid in: path description: 'The uuid for the medical problem.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a medical problem' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string - name: muuid in: path description: 'The uuid for the medical problem.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_medical_problem_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] delete: tags: - standard description: 'Delete a medical problem' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string - name: muuid in: path description: 'The uuid for the medical problem.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/allergy: get: tags: - standard description: 'Retrieves a list of allergies' parameters: - name: lists.pid in: query description: 'The uuid for the patient.' required: false schema: type: string - name: lists.id in: query description: 'The uuid for the allergy.' required: false schema: type: string - name: title in: query description: 'The title for the allergy.' required: false schema: type: string - name: begdate in: query description: 'The start date for the allergy.' required: false schema: type: string - name: enddate in: query description: 'The end date for the allergy.' required: false schema: type: string - name: diagnosis in: query description: 'The diagnosis for the allergy.' required: false schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/allergy/{auuid}': get: tags: - standard description: 'Retrieves a single allergy by their uuid' parameters: - name: auuid in: path description: 'The uuid for the allergy.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{puuid}/allergy': get: tags: - standard description: 'Retrieves all allergies for a patient' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new allergy' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_allergy_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{puuid}/allergy/{auuid}': get: tags: - standard description: 'Retrieves a allergy for a patient' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string - name: auuid in: path description: 'The uuid for the allergy.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a allergy' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string - name: auuid in: path description: 'The uuid for the allergy.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_allergy_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] delete: tags: - standard description: 'Delete a medical problem' parameters: - name: puuid in: path description: 'The uuid for the patient.' required: true schema: type: string - name: auuid in: path description: 'The uuid for the allergy.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/medication': get: tags: - standard description: 'Retrieves all medications for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new medication' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_medication_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/medication/{mid}': get: tags: - standard description: 'Retrieves a medication for a patient' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: mid in: path description: 'The id for the medication.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a medication' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: mid in: path description: 'The id for the medication.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_medication_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] delete: tags: - standard description: 'Delete a medication' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: mid in: path description: 'The id for the medication.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/surgery': get: tags: - standard description: 'Retrieves all surgeries for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new surgery' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_surgery_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/surgery/{sid}': get: tags: - standard description: 'Retrieves a surgery for a patient' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: sid in: path description: 'The id for the surgery.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a surgery' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: sid in: path description: 'The id for the surgery.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_surgery_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] delete: tags: - standard description: 'Delete a surgery' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: sid in: path description: 'The id for the surgery.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/dental_issue': get: tags: - standard description: 'Retrieves all dental issues for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new dental issue' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_dental_issue_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/dental_issue/{did}': get: tags: - standard description: 'Retrieves a dental issue for a patient' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: did in: path description: 'The id for the dental issue.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a dental issue' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: did in: path description: 'The id for the dental issue.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_dental_issue_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] delete: tags: - standard description: 'Delete a dental issue' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: did in: path description: 'The id for the dental issue.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/appointment': get: tags: - standard description: 'Retrieves all appointments for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new appointment' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: required: - pc_catid - pc_title - pc_duration - pc_hometext - pc_apptstatus - pc_eventDate - pc_startTime - pc_facility - pc_billing_location properties: pc_catid: description: 'The category of the appointment.' type: string pc_title: description: 'The title of the appointment.' type: string pc_duration: description: 'The duration of the appointment.' type: string pc_hometext: description: 'Comments for the appointment.' type: string pc_apptstatus: description: 'use an option from resource=/api/list/apptstat' type: string pc_eventDate: description: 'The date of the appointment.' type: string pc_startTime: description: 'The time of the appointment.' type: string pc_facility: description: 'The facility id of the appointment.' type: string pc_billing_location: description: 'The billinag location id of the appointment.' type: string pc_aid: description: 'The provider id for the appointment.' type: string type: object example: pc_catid: '5' pc_title: 'Office Visit' pc_duration: '900' pc_hometext: Test pc_apptstatus: '-' pc_eventDate: '2018-10-19' pc_startTime: '09:00' pc_facility: '9' pc_billing_location: '10' pc_aid: '1' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/appointment: get: tags: - standard description: 'Retrieves all appointments' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/appointment/{eid}': get: tags: - standard description: 'Retrieves an appointment' parameters: - name: eid in: path description: 'The eid for the appointment.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/appointment/{eid}': get: tags: - standard description: 'Retrieves a appointment for a patient' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: eid in: path description: 'The eid for the appointment.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] delete: tags: - standard description: 'Delete a appointment' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: eid in: path description: 'The eid for the appointment.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/list/{list_name}': get: tags: - standard description: 'Retrieves a list' parameters: - name: list_name in: path description: 'The list_id of the list.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/version: get: tags: - standard description: 'Retrieves the OpenEMR version information' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/product: get: tags: - standard description: 'Retrieves the OpenEMR product registration information' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/insurance_company: get: tags: - standard description: 'Retrieves all insurance companies' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new insurance company' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_insurance_company_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/insurance_company/{iid}': get: tags: - standard description: 'Retrieves insurance company' parameters: - name: iid in: path description: 'The id of the insurance company.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a insurance company' parameters: - name: iid in: path description: 'The id for the insurance company.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_insurance_company_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/insurance_type: get: tags: - standard description: 'Retrieves all insurance types' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/document': get: tags: - standard description: 'Retrieves all file information of documents from a category for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: path in: query description: 'The category of the documents.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new patient document' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: path in: query description: 'The category of the document.' required: true schema: type: string requestBody: required: true content: multipart/form-data: schema: properties: document: description: document type: string format: binary type: object responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/document/{did}': get: tags: - standard description: 'Retrieves a document for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: did in: path description: 'The id for the patient document.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/insurance': get: tags: - standard description: 'Retrieves all insurances for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/insurance/{type}': get: tags: - standard description: 'Retrieves a insurance (by type) for a patient' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: type in: path description: 'The insurance type for the patient. (options are ''primary'', ''secondary'', or ''tertiary'')' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] put: tags: - standard description: 'Edit a patient insurance (by type)' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: type in: path description: 'The insurance type for the patient. (options are ''primary'', ''secondary'', or ''tertiary'')' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_insurance_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a new patient insurance (with type)' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string - name: type in: path description: 'The insurance type for the patient. (options are ''primary'', ''secondary'', or ''tertiary'')' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_insurance_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/message': post: tags: - standard description: 'Submits a pnote message' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_message_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/transaction': get: tags: - standard description: 'Get Transactions for a patient' parameters: - name: pid in: path description: 'The pid for the patient' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - standard description: 'Submits a transaction' parameters: - name: pid in: path description: 'The pid for the patient.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_transaction_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/transaction/{tid}': put: tags: - standard description: 'Updates a transaction' parameters: - name: tid in: path description: 'The id for the transaction.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_transaction_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/patient/{pid}/message/{mid}': put: tags: - standard description: 'Edit a pnote message' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: mid in: path description: 'The id for the pnote message.' required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/api_message_request' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] delete: tags: - standard description: 'Delete a pnote message' parameters: - name: pid in: path description: 'The id for the patient.' required: true schema: type: string - name: eid in: path description: 'The id for the pnote message.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/immunization: get: tags: - standard description: 'Retrieves a list of immunizations' parameters: - name: patient_id in: query description: 'The pid for the patient.' required: false schema: type: string - name: id in: query description: 'The id for the immunization.' required: false schema: type: string - name: uuid in: query description: 'The uuid for the immunization.' required: false schema: type: string - name: administered_date in: query description: 'The administered date for the immunization.' required: false schema: type: string - name: immunization_id in: query description: 'The immunization list_id for the immunization.' required: false schema: type: string - name: cvx_code in: query description: 'The cvx code for the immunization.' required: false schema: type: string - name: manufacturer in: query description: 'The manufacturer for the immunization.' required: false schema: type: string - name: lot_number in: query description: 'The lot number for the immunization.' required: false schema: type: string - name: administered_by_id in: query description: 'The administered by id for the immunization.' required: false schema: type: string - name: administered_by in: query description: 'The administered by for the immunization.' required: false schema: type: string - name: education_date in: query description: 'The education date for the immunization.' required: false schema: type: string - name: vis_date in: query description: 'The vis date for the immunization.' required: false schema: type: string - name: note in: query description: 'The note for the immunization.' required: false schema: type: string - name: create_date in: query description: 'The create date for the immunization.' required: false schema: type: string - name: update_date in: query description: 'The update date for the immunization.' required: false schema: type: string - name: created_by in: query description: 'The created_by for the immunization.' required: false schema: type: string - name: updated_by in: query description: 'The updated_by for the immunization.' required: false schema: type: string - name: amount_administered in: query description: 'The amount administered for the immunization.' required: false schema: type: string - name: amount_administered_unit in: query description: 'The amount administered unit for the immunization.' required: false schema: type: string - name: expiration_date in: query description: 'The expiration date for the immunization.' required: false schema: type: string - name: route in: query description: 'The route for the immunization.' required: false schema: type: string - name: administration_site in: query description: 'The administration site for the immunization.' required: false schema: type: string - name: added_erroneously in: query description: 'The added_erroneously for the immunization.' required: false schema: type: string - name: external_id in: query description: 'The external_id for the immunization.' required: false schema: type: string - name: completion_status in: query description: 'The completion status for the immunization.' required: false schema: type: string - name: information_source in: query description: 'The information source for the immunization.' required: false schema: type: string - name: refusal_reason in: query description: 'The refusal reason for the immunization.' required: false schema: type: string - name: ordering_provider in: query description: 'The ordering provider for the immunization.' required: false schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/immunization/{uuid}': get: tags: - standard description: 'Retrieves a immunization' parameters: - name: uuid in: path description: 'The uuid for the immunization.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/procedure: get: tags: - standard description: 'Retrieves a list of all procedures' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/procedure/{uuid}': get: tags: - standard description: 'Retrieves a procedure' parameters: - name: uuid in: path description: 'The uuid for the procedure.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/drug: get: tags: - standard description: 'Retrieves a list of all drugs' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/drug/{uuid}': get: tags: - standard description: 'Retrieves a drug' parameters: - name: uuid in: path description: 'The uuid for the drug.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /api/prescription: get: tags: - standard description: 'Retrieves a list of all prescriptions' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/api/prescription/{uuid}': get: tags: - standard description: 'Retrieves a prescription' parameters: - name: uuid in: path description: 'The uuid for the prescription.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/AllergyIntolerance: get: tags: - fhir description: 'Returns a list of AllergyIntolerance resources.' parameters: - name: _id in: query description: 'The uuid for the AllergyIntolerance resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/AllergyIntolerance' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/AllergyIntolerance/{uuid}': get: tags: - fhir description: 'Returns a single AllergyIntolerance resource.' parameters: - name: uuid in: path description: 'The uuid for the AllergyIntolerance resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 94682fe5-f383-4885-9505-64b02e34906f meta: { versionId: '1', lastUpdated: '2021-09-16T00:27:32+00:00' } resourceType: AllergyIntolerance text: { status: additional, div: '
penicillin
' } clinicalStatus: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical', code: active, display: Active }] } verificationStatus: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/allergyintolerance-verification', code: confirmed, display: Confirmed }] } category: [medication] criticality: low code: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/data-absent-reason', code: unknown, display: Unknown }] } patient: { reference: Patient/94682ef5-b0e3-4289-b19a-11b9592e9c92 } reaction: [{ manifestation: [{ coding: [{ system: 'http://snomed.info/sct', code: '422587007', display: Nausea }], text: Nausea }] }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/CarePlan: get: tags: - fhir description: 'Returns a list of CarePlan resources.' parameters: - name: _id in: query description: 'The uuid for the CarePlan resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: category in: query description: 'The category of the CarePlan resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/CarePlan' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/CarePlan/{uuid}': get: tags: - fhir description: 'Returns a single CarePlan resource.' parameters: - name: uuid in: path description: 'The uuid for the CarePlan resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 94682f08-8fbc-451e-b1ec-f922d765c38f_1 meta: { versionId: '1', lastUpdated: '2021-09-16T00:54:18+00:00' } resourceType: CarePlan text: { status: generated, div: '

Treat flu.

' } status: active intent: plan category: [{ coding: [{ system: 'http://hl7.org/fhir/us/core/CodeSystem/careplan-category', code: assess-plan }] }] description: 'Treat flu.' subject: { reference: Patient/94682ef5-b0e3-4289-b19a-11b9592e9c92, type: Patient } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/CareTeam: get: tags: - fhir description: 'Returns a list of CareTeam resources.' parameters: - name: _id in: query description: 'The uuid for the CareTeam resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: status in: query description: 'The status of the CarePlan resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/CareTeam' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/CareTeam/{uuid}': get: tags: - fhir description: 'Returns a single CareTeam resource.' parameters: - name: uuid in: path description: 'The uuid for the CareTeam resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 94682f09-69fe-4ada-8ea6-753a52bd1516 meta: { versionId: '1', lastUpdated: '2021-09-16T01:07:22+00:00' } resourceType: CareTeam status: active subject: { reference: Patient/94682ef5-b0e3-4289-b19a-11b9592e9c92, type: Patient } participant: [{ role: [{ coding: [{ system: 'http://nucc.org/provider-taxonomy', code: 102L00000X, display: Psychoanalyst }] }], member: { reference: Practitioner/94682c68-f712-4c39-9158-ff132a08f26b, type: Practitioner }, onBehalfOf: { reference: Organization/94682c62-b801-4498-84a1-13f158bb2a18, type: Organization } }, { role: [{ coding: [{ system: 'http://terminology.hl7.org/CodeSystem/data-absent-reason', code: unknown, display: Unknown }] }], member: { reference: Organization/94682c62-b801-4498-84a1-13f158bb2a18, type: Organization } }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Condition: get: tags: - fhir description: 'Returns a list of Condition resources.' parameters: - name: _id in: query description: 'The uuid for the Condition resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Condition' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Condition/{uuid}': get: tags: - fhir description: 'Returns a single Condition resource.' parameters: - name: uuid in: path description: 'The uuid for the Condition resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 94682c68-e5bb-4c5c-859a-cebaa5a1e582 meta: { versionId: '1', lastUpdated: '2021-09-16T02:41:53+00:00' } resourceType: Condition clinicalStatus: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/condition-clinical', code: inactive, display: Inactive }] } verificationStatus: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/condition-ver-status', code: unconfirmed, display: Unconfirmed }] } category: [{ coding: [{ system: 'http://terminology.hl7.org/CodeSystem/condition-category', code: problem-list-item, display: 'Problem List Item' }] }] code: { coding: [{ system: 'http://snomed.info/sct', code: '444814009', display: '' }] } subject: { reference: Patient/94682c62-d37e-48b5-8018-c5f6f3566609 } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Coverage: get: tags: - fhir description: 'Returns a list of Coverage resources.' parameters: - name: _id in: query description: 'The uuid for the Coverage resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: payor in: query description: 'The payor of the Coverage resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Coverage' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Coverage/{uuid}': get: tags: - fhir description: 'Returns a single Coverage resource.' parameters: - name: uuid in: path description: 'The uuid for the Coverage resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 960d5f10-edc6-4c65-a6d4-39a1e1da87a8 meta: { versionId: '1', lastUpdated: '2022-04-14T07:58:45+00:00' } resourceType: Coverage status: active beneficiary: { reference: Patient/960d5f08-9fdf-4bdc-9108-84a149e28bac } relationship: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/subscriber-relationship', code: '' }] } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Device: get: tags: - fhir description: 'Returns a list of Device resources.' parameters: - name: _id in: query description: 'The uuid for the Device resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Device' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Device/{uuid}': get: tags: - fhir description: 'Returns a single Device resource.' parameters: - name: uuid in: path description: 'The uuid for the Device resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 946dce19-c80a-402c-862a-eadf3f2377f0 meta: { versionId: '1', lastUpdated: '2021-09-18T19:28:59+00:00' } resourceType: Device udiCarrier: [{ deviceIdentifier: '08717648200274', carrierHRF: '=/08717648200274=,000025=A99971312345600=>014032=}013032&,1000000000000XYZ123' }] distinctIdentifier: A99971312345600 manufactureDate: '2013-02-01' expirationDate: '2014-02-01' lotNumber: 000000000000XYZ123 serialNumber: '000025' type: { extension: [{ valueCode: unknown, url: 'http://hl7.org/fhir/StructureDefinition/data-absent-reason' }] } patient: { reference: Patient/946da619-c631-431a-a282-487cd6fb7802, type: Patient } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/DiagnosticReport: get: tags: - fhir description: 'Returns a list of DiagnosticReport resources.' parameters: - name: _id in: query description: 'The uuid for the DiagnosticReport resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: code in: query description: 'The code of the DiagnosticReport resource.' required: false schema: type: string - name: category in: query description: 'The category of the DiagnosticReport resource.' required: false schema: type: string - name: date in: query description: 'The datetime of the DiagnosticReport resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/DiagnosticReport' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/DiagnosticReport/{uuid}': get: tags: - fhir description: 'Returns a single DiagnosticReport resource.' parameters: - name: uuid in: path description: 'The uuid for the DiagnosticReport resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 93fb2d6a-77ac-48ca-a12d-1a17e40007e3 meta: { versionId: '1', lastUpdated: '2021-09-18T20:52:34+00:00' } resourceType: DiagnosticReport status: final category: [{ coding: [{ system: 'http://loinc.org', code: LP7839-6, display: Pathology }] }] code: { coding: [{ system: 'http://loinc.org', code: 11502-2, display: 'Laboratory report' }] } subject: { reference: Patient/9353b8f5-0a87-4e2a-afd4-25341fdb0fbc, type: Patient } encounter: { reference: Encounter/93540818-cb5f-49df-b73b-83901bb793b6, type: Encounter } effectiveDateTime: '2015-06-22T00:00:00+00:00' issued: '2015-06-22T00:00:00+00:00' performer: [{ reference: Organization/935249b5-0ba6-4b5b-8863-a7a27d4c6350, type: Organization }] presentedForm: [{ contentType: text/plain, data: TXMgQWxpY2UgTmV3bWFuIHdhcyB0ZXN0ZWQgZm9yIHRoZSBVcmluYW5hbHlzaXMgbWFjcm8gcGFuZWwgYW5kIHRoZSByZXN1bHRzIGhhdmUgYmVlbiBmb3VuZCB0byBiZSANCm5vcm1hbC4= }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/DocumentReference: get: tags: - fhir description: 'Returns a list of DocumentReference resources.' parameters: - name: _id in: query description: 'The uuid for the DocumentReference resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: type in: query description: 'The type of the DocumentReference resource.' required: false schema: type: string - name: category in: query description: 'The category of the DocumentReference resource.' required: false schema: type: string - name: date in: query description: 'The datetime of the DocumentReference resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/DocumentReference' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/DocumentReference/$docref: post: tags: - fhir description: 'The $docref operation is used to request the server generates a document based on the specified parameters. If no additional parameters are specified then a DocumentReference to the patient''s most current Clinical Summary of Care Document (CCD) is returned. The document itself is retrieved using the DocumentReference.content.attachment.url element. See http://hl7.org/fhir/us/core/OperationDefinition-docref.html for more details.' externalDocs: description: 'Detailed documentation on this operation' url: 'https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' parameters: - name: patient in: query description: 'The uuid for the patient.' required: true schema: type: string - name: start in: query description: 'The datetime refers to care dates not record currency dates. All records relating to care provided in a certain date range. If no start date is provided then all documents prior to the end date are in scope. If no start and end date are provided, the most recent or current document is in scope.' required: false schema: type: string - name: end in: query description: 'The datetime refers to care dates not record currency dates. All records relating to care provided in a certain date range. If no end date is provided then all documents subsequent to the start date are in scope. If no start and end date are provided, the most recent or current document is in scope.' required: false schema: type: string - name: type in: query description: 'The type refers to the document type. This is a LOINC code from the valueset of http://hl7.org/fhir/R4/valueset-c80-doc-typecodes.html. The server currently only supports the LOINC code of 34133-9 (Summary of episode node).' required: false schema: type: string responses: '200': description: 'A search bundle of DocumentReferences is returned' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/DocumentReference/{uuid}': get: tags: - fhir description: 'Returns a single DocumentReference resource.' parameters: - name: uuid in: path description: 'The uuid for the DocumentReference resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 946e7553-1aaa-49f8-8f81-ae15ccaa9165 meta: { versionId: '1', lastUpdated: '2021-09-19T03:17:51+00:00' } resourceType: DocumentReference identifier: [{ value: 946e7553-1aaa-49f8-8f81-ae15ccaa9165 }] status: current type: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/v3-NullFlavor', code: UNK, display: unknown }] } category: [{ coding: [{ system: 'https://localhost:9300/apis/default/fhir/ValueSet/openemr-document-types', code: openemr-document, display: 'OpenEMR Document' }] }] subject: { reference: Patient/946da619-c631-431a-a282-487cd6fb7802, type: Patient } date: '2021-09-19T03:15:56+00:00' author: [null] content: [{ attachment: { contentType: image/gif, url: 'https://localhost:9300/apis/default/fhir/Document/7/Binary' }, format: { system: 'http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem', code: 'urn:ihe:iti:xds:2017:mimeTypeSufficient', display: 'mimeType Sufficient' } }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] '/fhir/Document/{id}/Binary': get: tags: - fhir description: 'Used for downloading binary documents generated either with BULK FHIR Export or with the $docref CCD export operation. Documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' parameters: - name: id in: path description: 'The id for the Document.' required: true schema: type: string responses: '200': description: 'The documentation for working with BULK FHIR or $docref document exports can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/Encounter: get: tags: - fhir description: 'Returns a list of Encounter resources.' parameters: - name: _id in: query description: 'The uuid for the Encounter resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: date in: query description: 'The datetime of the Encounter resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Encounter' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Encounter/{uuid}': get: tags: - fhir description: 'Returns a single Encounter resource.' parameters: - name: uuid in: path description: 'The uuid for the Encounter resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 946da61d-6b95-4f8e-abe5-534a25913b71 meta: { versionId: '1', lastUpdated: '2021-09-19T06:27:41+00:00' } resourceType: Encounter identifier: [{ system: 'urn:ietf:rfc:3986', value: 946da61d-6b95-4f8e-abe5-534a25913b71 }] status: finished class: { system: 'http://terminology.hl7.org/CodeSystem/v3-ActCode', code: AMB, display: ambulatory } type: [{ coding: [{ system: 'http://snomed.info/sct', code: '185349003', display: 'Encounter for check up (procedure)' }] }] subject: { reference: Patient/946da61b-626b-4f88-81e2-adfb88f4f0fe, type: Patient } participant: [{ type: [{ coding: [{ system: 'http://terminology.hl7.org/CodeSystem/v3-ParticipationType', code: PPRF, display: 'Primary Performer' }] }], period: { start: '2012-08-13T00:00:00+00:00' }, individual: { reference: Practitioner/946da61d-ac5f-4fdc-b3f2-7b58dc49976b, type: Practitioner } }] period: { start: '2012-08-13T00:00:00+00:00' } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Goal: get: tags: - fhir description: 'Returns a list of Condition resources.' parameters: - name: _id in: query description: 'The uuid for the Goal resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Goal' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Goal/{uuid}': get: tags: - fhir description: 'Returns a single Goal resource.' parameters: - name: uuid in: path description: 'The uuid for the Goal resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 946da61d-6b88-4d54-bdd6-4029e2ad9e3f_1 meta: { versionId: '1', lastUpdated: '2021-09-19T06:45:58+00:00' } resourceType: Goal lifecycleStatus: active description: { text: 'Eating more vegetables.' } subject: { reference: Patient/946da619-c631-431a-a282-487cd6fb7802, type: Patient } target: [{ measure: { extension: [{ valueCode: unknown, url: 'http://hl7.org/fhir/StructureDefinition/data-absent-reason' }] }, detailString: 'Eating more vegetables.', dueDate: '2021-09-09' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Group: get: tags: - fhir description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' parameters: - name: _id in: query description: 'The uuid for the Group resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Group' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Group/{uuid}': get: tags: - fhir description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' parameters: - name: uuid in: path description: 'The uuid for the Group resource.' required: true schema: type: string responses: '200': description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] '/fhir/Group/{id}/$export': get: tags: - fhir description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' responses: '200': description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/Immunization: get: tags: - fhir description: 'Returns a list of Immunization resources.' parameters: - name: _id in: query description: 'The uuid for the Immunization resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Immunization' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Immunization/{uuid}': get: tags: - fhir description: 'Returns a single Immunization resource.' parameters: - name: uuid in: path description: 'The uuid for the Immunization resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 95e8d8b7-e3e2-4e03-8eb1-31e1d9097d8f meta: { versionId: '1', lastUpdated: '2022-03-26T05:42:59+00:00' } resourceType: Immunization status: completed vaccineCode: { coding: [{ system: 'http://hl7.org/fhir/sid/cvx', code: '207', display: 'SARS-COV-2 (COVID-19) vaccine, mRNA, spike protein, LNP, preservative free, 100 mcg/0.5mL dose' }] } patient: { reference: Patient/95e8d830-3068-48cf-930a-2fefb18c2bcf } occurrenceDateTime: '2022-03-26T05:35:00+00:00' recorded: '2022-03-26T05:42:26+00:00' primarySource: false '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Location: get: tags: - fhir description: 'Returns a list of Location resources.' parameters: - name: _id in: query description: 'The uuid for the Location resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Location' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Location/{uuid}': get: tags: - fhir description: 'Returns a single Location resource.' parameters: - name: uuid in: path description: 'The uuid for the Location resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 946da61d-c4f2-4f03-a2a7-b571f6a24b65 meta: { versionId: '1', lastUpdated: '2021-09-19T08:14:58+00:00' } resourceType: Location status: active name: 'Your Clinic Name Here' telecom: [{ system: phone, value: 000-000-0000 }, { system: fax, value: 000-000-0000 }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Medication: get: tags: - fhir description: 'Returns a list of Medication resources.' responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Medication' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Medication/{uuid}': get: tags: - fhir description: 'Returns a single Medication resource.' parameters: - name: uuid in: path description: 'The uuid for the Medication resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 961aa334-9348-4145-8252-de665e3c4afa meta: { versionId: '1', lastUpdated: '2022-04-19T23:42:14+00:00' } resourceType: Medication code: { coding: [{ system: 'http://www.nlm.nih.gov/research/umls/rxnorm', code: 153165 }] } status: active batch: { lotNumber: '132', expirationDate: '0000-00-00' } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/MedicationRequest: get: tags: - fhir description: 'Returns a list of MedicationRequest resources.' parameters: - name: _id in: query description: 'The uuid for the MedicationRequest resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: intent in: query description: 'The intent of the MedicationRequest resource.' required: false schema: type: string - name: status in: query description: 'The status of the MedicationRequest resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/MedicationRequest' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/MedicationRequest/{uuid}': get: tags: - fhir description: 'Returns a single MedicationRequest resource.' parameters: - name: uuid in: path description: 'The uuid for the MedicationRequest resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 946da61d-9cff-4416-8d27-805f19f9d7d8 meta: { versionId: '1', lastUpdated: '2021-09-20T04:03:14+00:00' } resourceType: MedicationRequest status: active intent: order category: [{ coding: [{ system: 'http://terminology.hl7.org/CodeSystem/medicationrequest-category', code: community, display: Home/Community }] }] reportedBoolean: false medicationCodeableConcept: { coding: [{ system: 'http://www.nlm.nih.gov/research/umls/rxnorm', code: '1738139', display: 'Acetaminophen 325 MG Oral Tablet' }] } subject: { reference: Patient/946da617-1a4a-4b2c-ae66-93b84377cb1e, type: Patient } authoredOn: '2021-09-18T00:00:00+00:00' requester: { reference: Practitioner/946da61d-ac5f-4fdc-b3f2-7b58dc49976b, type: Practitioner } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Observation: get: tags: - fhir description: 'Returns a list of Observation resources.' parameters: - name: _id in: query description: 'The uuid for the Observation resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: code in: query description: 'The code of the Observation resource.' required: false schema: type: string - name: category in: query description: 'The category of the Observation resource.' required: false schema: type: string - name: date in: query description: 'The datetime of the Observation resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Observation' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Observation/{uuid}': get: tags: - fhir description: 'Returns a single Observation resource.' parameters: - name: uuid in: path description: 'The uuid for the Observation resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 946da61e-0597-485e-9dfd-a87205ea56b3 meta: { versionId: '1', lastUpdated: '2021-09-20T04:12:16+00:00' } resourceType: Observation status: final category: [{ coding: [{ system: 'http://terminology.hl7.org/CodeSystem/observation-category', code: vital-signs }] }] code: { coding: [{ system: 'http://loinc.org', code: 85354-9, display: 'Blood pressure systolic and diastolic' }] } subject: { reference: Patient/946da619-c631-431a-a282-487cd6fb7802, type: Patient } effectiveDateTime: '2015-08-31T00:00:00+00:00' component: [{ code: { coding: [{ system: 'http://loinc.org', code: 8480-6, display: 'Systolic blood pressure' }] }, valueQuantity: { value: 122, unit: 'mm[Hg]', system: 'http://unitsofmeasure.org', code: 'mm[Hg]' } }, { code: { coding: [{ system: 'http://loinc.org', code: 8462-4, display: 'Diastolic blood pressure' }] }, valueQuantity: { value: 77, unit: 'mm[Hg]', system: 'http://unitsofmeasure.org', code: 'mm[Hg]' } }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Organization: get: tags: - fhir description: 'Returns a list of Organization resources.' parameters: - name: _id in: query description: 'The uuid for the Organization resource.' required: false schema: type: string - name: name in: query description: 'The name of the Organization resource.' required: false schema: type: string - name: email in: query description: 'The email of the Organization resource.' required: false schema: type: string - name: phone in: query description: 'The phone of the Organization resource.' required: false schema: type: string - name: telecom in: query description: 'The telecom of the Organization resource.' required: false schema: type: string - name: address in: query description: 'The address of the Organization resource.' required: false schema: type: string - name: address-city in: query description: 'The address-city of the Organization resource.' required: false schema: type: string - name: address-postalcode in: query description: 'The address-postalcode of the Organization resource.' required: false schema: type: string - name: address-state in: query description: 'The address-state of the Organization resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Organization' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - fhir description: 'Adds a Organization resource.' requestBody: required: true content: application/json: schema: description: 'The json object for the Organization resource.' type: object example: id: 95f0e672-be37-4c73-95c9-649c2d200018 meta: versionId: '1' lastUpdated: '2022-03-30T07:43:23+00:00' resourceType: Organization text: status: generated div: '

Your Clinic Name Here

' identifier: - system: 'http://hl7.org/fhir/sid/us-npi' value: '1234567890' active: true type: - coding: [{ system: 'http://terminology.hl7.org/CodeSystem/organization-type', code: prov, display: 'Healthcare Provider' }] name: 'Your Clinic Name Here Hey' telecom: - system: phone value: 000-000-0000 use: work - system: fax value: 000-000-0000 use: work address: - null responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 95f0e672-be37-4c73-95c9-649c2d200018 meta: { versionId: '1', lastUpdated: '2022-03-30T07:43:23+00:00' } resourceType: Organization text: { status: generated, div: '

Your Clinic Name Here

' } identifier: [{ system: 'http://hl7.org/fhir/sid/us-npi', value: '1234567890' }] active: true type: [{ coding: [{ system: 'http://terminology.hl7.org/CodeSystem/organization-type', code: prov, display: 'Healthcare Provider' }] }] name: 'Your Clinic Name Here Now' telecom: [{ system: phone, value: 000-000-0000, use: work }, { system: fax, value: 000-000-0000, use: work }] address: [null] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Organization/{uuid}': get: tags: - fhir description: 'Returns a single Organization resource.' parameters: - name: uuid in: path description: 'The uuid for the Organization resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 95f0e672-be37-4c73-95c9-649c2d200018 meta: { versionId: '1', lastUpdated: '2022-03-30T07:43:23+00:00' } resourceType: Organization text: { status: generated, div: '

Your Clinic Name Here

' } identifier: [{ system: 'http://hl7.org/fhir/sid/us-npi', value: '1234567890' }] active: true type: [{ coding: [{ system: 'http://terminology.hl7.org/CodeSystem/organization-type', code: prov, display: 'Healthcare Provider' }] }] name: 'Your Clinic Name Here' telecom: [{ system: phone, value: 000-000-0000, use: work }, { system: fax, value: 000-000-0000, use: work }] address: [null] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] put: tags: - fhir description: 'Modifies a Organization resource.' parameters: - name: uuid in: path description: 'The uuid for the organization.' required: true schema: type: string requestBody: required: true content: application/json: schema: description: 'The json object for the Organization resource.' type: object example: id: 95f0e672-be37-4c73-95c9-649c2d200018 meta: versionId: '1' lastUpdated: '2022-03-30T07:43:23+00:00' resourceType: Organization text: status: generated div: '

Your Clinic Name Here

' identifier: - system: 'http://hl7.org/fhir/sid/us-npi' value: '1234567890' active: true type: - coding: [{ system: 'http://terminology.hl7.org/CodeSystem/organization-type', code: prov, display: 'Healthcare Provider' }] name: 'Your Clinic Name Here' telecom: - system: phone value: 000-000-0000 use: work - system: fax value: 000-000-0000 use: work address: - null responses: '201': description: 'Standard Response' content: application/json: schema: example: id: 14 uuid: 95f217c1-258c-44ca-bf11-909dce369574 '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/Patient: get: tags: - fhir description: 'Returns a list of Patient resources.' parameters: - name: _id in: query description: 'The uuid for the Patient resource.' required: false schema: type: string - name: identifier in: query description: 'The identifier of the Patient resource.' required: false schema: type: string - name: name in: query description: 'The name of the Patient resource.' required: false schema: type: string - name: birthdate in: query description: 'The birthdate of the Patient resource.' required: false schema: type: string - name: gender in: query description: 'The gender of the Patient resource.' required: false schema: type: string - name: address in: query description: 'The address of the Patient resource.' required: false schema: type: string - name: address-city in: query description: 'The address-city of the Patient resource.' required: false schema: type: string - name: address-postalcode in: query description: 'The address-postalcode of the Patient resource.' required: false schema: type: string - name: address-state in: query description: 'The address-state of the Patient resource.' required: false schema: type: string - name: email in: query description: 'The email of the Patient resource.' required: false schema: type: string - name: family in: query description: 'The family name of the Patient resource.' required: false schema: type: string - name: given in: query description: 'The given name of the Patient resource.' required: false schema: type: string - name: phone in: query description: 'The phone number of the Patient resource.' required: false schema: type: string - name: telecom in: query description: 'The fax number of the Patient resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Patient' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - fhir description: 'Adds a Patient resource.' requestBody: required: true content: application/json: schema: description: 'The json object for the Patient resource.' type: object example: id: 95f22ff4-dd25-4290-8b52-1dd2fedf8e54 meta: versionId: '1' lastUpdated: '2022-03-31T02:48:28+00:00' resourceType: Patient text: status: generated div: '

Brenda Smith

' extension: - valueCode: F url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex' - extension: [{ valueCoding: { system: 'http://terminology.hl7.org/CodeSystem/v3-NullFlavor', code: UNK, display: Unknown }, url: ombCategory }, { valueString: Unknown, url: text }] url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race' identifier: - use: official type: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/v2-0203', code: PT }] } system: 'http://terminology.hl7.org/CodeSystem/v2-0203' value: '1' active: true name: - use: official family: Smith given: [Brenda] gender: female birthDate: '2017-03-10' communication: - language: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/data-absent-reason', code: unknown, display: Unknown }] } responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 95f22ff4-dd25-4290-8b52-1dd2fedf8e54 meta: { versionId: '1', lastUpdated: '2022-03-31T02:48:28+00:00' } resourceType: Patient text: { status: generated, div: '

Brenda Smith

' } extension: [{ valueCode: F, url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex' }, { extension: [{ valueCoding: { system: 'http://terminology.hl7.org/CodeSystem/v3-NullFlavor', code: UNK, display: Unknown }, url: ombCategory }, { valueString: Unknown, url: text }], url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race' }] identifier: [{ use: official, type: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/v2-0203', code: PT }] }, system: 'http://terminology.hl7.org/CodeSystem/v2-0203', value: '1' }] active: true name: [{ use: official, family: Smith, given: [Brenda] }] gender: female birthDate: '2017-03-10' communication: [{ language: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/data-absent-reason', code: unknown, display: Unknown }] } }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Patient/{uuid}': get: tags: - fhir description: 'Returns a single Patient resource.' parameters: - name: uuid in: path description: 'The uuid for the Patient resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 946da617-1a4a-4b2c-ae66-93b84377cb1e meta: { versionId: '1', lastUpdated: '2021-09-21T17:08:03+00:00' } resourceType: Patient text: { status: generated, div: '

Aurore252 Von197

' } extension: [{ valueCode: F, url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex' }, { extension: [{ valueCoding: { system: 'urn:oid:2.16.840.1.113883.6.238', code: 1006-6, display: Abenaki }, url: ombCategory }, { valueString: Abenaki, url: text }], url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race' }, { extension: [{ valueString: 'Declined To Specify', url: text }], url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity' }] identifier: [{ use: official, type: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/v2-0203', code: PT }] }, system: 'http://terminology.hl7.org/CodeSystem/v2-0203', value: '1' }] active: true name: [{ use: official, family: Von197, given: [Aurore252] }] gender: female birthDate: '1970-07-03' address: [{ line: ['245 Crona Wall'], city: Boston, state: Massachusetts, postalCode: '02215', period: { start: '2020-09-21T17:08:03.532+00:00' } }] communication: [{ language: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/data-absent-reason', code: unknown, display: Unknown }] } }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] put: tags: - fhir description: 'Modifies a Patient resource.' parameters: - name: uuid in: path description: 'The uuid for the Patient resource.' required: true schema: type: string requestBody: required: true content: application/json: schema: description: 'The json object for the Patient resource.' type: object example: id: 95f22ff4-dd25-4290-8b52-1dd2fedf8e54 meta: versionId: '1' lastUpdated: '2022-03-31T02:48:28+00:00' resourceType: Patient text: status: generated div: '

Brenda Smith

' extension: - valueCode: F url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex' - extension: [{ valueCoding: { system: 'http://terminology.hl7.org/CodeSystem/v3-NullFlavor', code: UNK, display: Unknown }, url: ombCategory }, { valueString: Unknown, url: text }] url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race' identifier: - use: official type: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/v2-0203', code: PT }] } system: 'http://terminology.hl7.org/CodeSystem/v2-0203' value: '1' active: true name: - use: official family: Smith given: [Brenda] gender: female birthDate: '2017-03-10' communication: - language: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/data-absent-reason', code: unknown, display: Unknown }] } responses: '201': description: 'Standard Response' content: application/json: schema: example: id: 2 uuid: 95f2ad04-5834-4243-8838-e396a7faadbf '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/Patient/$export: get: tags: - fhir description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' responses: '200': description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/Person: get: tags: - fhir description: 'Returns a list of Person resources.' parameters: - name: name in: query description: 'The name of the Person resource.' required: false schema: type: string - name: active in: query description: 'The active status of the Person resource.' required: false schema: type: string - name: address in: query description: 'The address of the Person resource.' required: false schema: type: string - name: address-city in: query description: 'The address-city of the Person resource.' required: false schema: type: string - name: address-postalcode in: query description: 'The address-postalcode of the Person resource.' required: false schema: type: string - name: address-state in: query description: 'The address-state of the Person resource.' required: false schema: type: string - name: email in: query description: 'The email of the Person resource.' required: false schema: type: string - name: family in: query description: 'The family name of the Person resource.' required: false schema: type: string - name: given in: query description: 'The given name of the Person resource.' required: false schema: type: string - name: phone in: query description: 'The phone number of the Person resource.' required: false schema: type: string - name: telecom in: query description: 'The fax number of the Person resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Person' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Person/{uuid}': get: tags: - fhir description: 'Returns a single Person resource.' parameters: - name: uuid in: path description: 'The uuid for the Person resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 960c7cd6-187a-4119-8cd4-85389d80efb9 meta: { versionId: '1', lastUpdated: '2022-04-13T08:57:32+00:00' } resourceType: Person text: { status: generated, div: '

Administrator Administrator

' } name: [{ use: official, family: Administrator, given: [Administrator, Larry] }] telecom: [{ system: phone, value: '1234567890', use: home }, { system: phone, value: '1234567890', use: work }, { system: phone, value: '1234567890', use: mobile }, { system: email, value: hey@hey.com, use: home }] address: [{ line: ['123 Lane Street'], city: Bellevue, state: WA, period: { start: '2021-04-13T08:57:32.146+00:00' } }] active: true '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Practitioner: get: tags: - fhir description: 'Returns a list of Practitioner resources.' parameters: - name: _id in: query description: 'The uuid for the Practitioner resource.' required: false schema: type: string - name: name in: query description: 'The name of the Practitioner resource.' required: false schema: type: string - name: active in: query description: 'The active status of the Practitioner resource.' required: false schema: type: string - name: address in: query description: 'The address of the Practitioner resource.' required: false schema: type: string - name: address-city in: query description: 'The address-city of the Practitioner resource.' required: false schema: type: string - name: address-postalcode in: query description: 'The address-postalcode of the Practitioner resource.' required: false schema: type: string - name: address-state in: query description: 'The address-state of the Practitioner resource.' required: false schema: type: string - name: email in: query description: 'The email of the Practitioner resource.' required: false schema: type: string - name: family in: query description: 'The family name of the Practitioner resource.' required: false schema: type: string - name: given in: query description: 'The given name of the Practitioner resource.' required: false schema: type: string - name: phone in: query description: 'The phone number of the Practitioner resource.' required: false schema: type: string - name: telecom in: query description: 'The fax number of the Practitioner resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Practitioner' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] post: tags: - fhir description: 'Adds a Practitioner resources.' requestBody: required: true content: application/json: schema: description: 'The json object for the Practitioner resource.' type: object example: id: 9473b0cf-e969-4eaa-8044-51037767fa4f meta: versionId: '1' lastUpdated: '2021-09-21T17:41:57+00:00' resourceType: Practitioner text: status: generated div: '

Billy Smith

' identifier: - system: 'http://hl7.org/fhir/sid/us-npi' value: '11223344554543' active: true name: - use: official family: Smith given: [Danny] responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 9473b0cf-e969-4eaa-8044-51037767fa4f meta: { versionId: '1', lastUpdated: '2021-09-21T17:41:57+00:00' } resourceType: Practitioner text: { status: generated, div: '

Billy Smith

' } identifier: [{ system: 'http://hl7.org/fhir/sid/us-npi', value: '11223344554543' }] active: true name: [{ use: official, family: Smith, given: [Danny] }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Practitioner/{uuid}': get: tags: - fhir description: 'Returns a single Practitioner resource.' parameters: - name: uuid in: path description: 'The uuid for the Practitioner resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 9473b0cf-e969-4eaa-8044-51037767fa4f meta: { versionId: '1', lastUpdated: '2021-09-21T17:41:57+00:00' } resourceType: Practitioner text: { status: generated, div: '

Billy Smith

' } identifier: [{ system: 'http://hl7.org/fhir/sid/us-npi', value: '11223344554543' }] active: true name: [{ use: official, family: Smith, given: [Billy] }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] put: tags: - fhir description: 'Modify a Practitioner resource.' parameters: - name: uuid in: path description: 'The uuid for the Practitioner resource.' required: true schema: type: string requestBody: required: true content: application/json: schema: description: 'The json object for the Practitioner resource.' type: object example: id: 9473b0cf-e969-4eaa-8044-51037767fa4f meta: versionId: '1' lastUpdated: '2021-09-21T17:41:57+00:00' resourceType: Practitioner text: status: generated div: '

Billy Smith

' identifier: - system: 'http://hl7.org/fhir/sid/us-npi' value: '11223344554543' active: true name: - use: official family: Smith given: [Billy] responses: '201': description: 'Standard Response' content: application/json: schema: example: id: 5 uuid: 95f294d7-e14c-441d-81a6-309fe369ee21 '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/PractitionerRole: get: tags: - fhir description: 'Returns a list of PractitionerRole resources.' parameters: - name: specialty in: query description: 'The specialty of the PractitionerRole resource.' required: false schema: type: string - name: practitioner in: query description: 'The practitioner of the PractitionerRole resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/PractitionerRole' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/PractitionerRole/{uuid}': get: tags: - fhir description: 'Returns a single PractitionerRole resource.' parameters: - name: uuid in: path description: 'The uuid for the PractitionerRole resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 960c806f-9463-482e-b228-67b5be1fed55 meta: { versionId: '1', lastUpdated: '2022-04-13T06:18:17+00:00' } resourceType: PractitionerRole practitioner: { reference: Practitioner/960c7cd6-187a-4119-8cd4-85389d80efb9, display: 'Administrator Administrator' } organization: { reference: Organization/960c7cc6-b4ae-49bc-877b-1a2913271c43, display: 'Your Clinic Name Here' } code: [{ coding: [102L00000X], text: Psychoanalyst }, { coding: [101Y00000X], text: Counselor }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Procedure: get: tags: - fhir description: 'Returns a list of Procedure resources.' parameters: - name: _id in: query description: 'The uuid for the Procedure resource.' required: false schema: type: string - name: patient in: query description: 'The uuid for the patient.' required: false schema: type: string - name: date in: query description: 'The datetime of the Procedure resource.' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Procedure' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/fhir/Procedure/{uuid}': get: tags: - fhir description: 'Returns a single Procedure resource.' parameters: - name: uuid in: path description: 'The uuid for the Procedure resource.' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 95e9d3fb-fe7b-448a-aa60-d40b11b486a5 meta: { versionId: '1', lastUpdated: '2022-03-26T17:20:14+00:00' } resourceType: Procedure status: in-progress subject: { reference: Patient/95e8d830-3068-48cf-930a-2fefb18c2bcf, type: Patient } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] '/fhir/Provenance/{uuid}': get: tags: - fhir description: 'Returns a single Provenance resource.' parameters: - name: uuid in: path description: 'The id for the Provenance resource. Format is \:\ (Example: AllergyIntolerance:95ea43f3-1066-4bc7-b224-6c23b985f145).' required: true schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: id: 'AllergyIntolerance:95ea43f3-1066-4bc7-b224-6c23b985f145' resourceType: Provenance target: [{ reference: AllergyIntolerance/95ea43f3-1066-4bc7-b224-6c23b985f145, type: AllergyIntolerance }] recorded: '2022-03-26T22:43:30+00:00' agent: { '0': { type: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/provenance-participant-type', code: author, display: Author }] }, who: { reference: Organization/95e8d810-7e55-44aa-bb48-fecd5b0d88c7, type: Organization }, onBehalfOf: { reference: Organization/95e8d810-7e55-44aa-bb48-fecd5b0d88c7, type: Organization } }, '1': { type: { coding: [{ system: 'http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type', code: transmitter, display: Transmitter }] } }, who: { reference: Organization/95e8d810-7e55-44aa-bb48-fecd5b0d88c7, type: Organization }, onBehalfOf: { reference: Organization/95e8d810-7e55-44aa-bb48-fecd5b0d88c7, type: Organization } } '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/uuidnotfound' security: - openemr_auth: [] /fhir/Provenance: get: tags: - fhir description: 'Returns a list of Provenance resources.' parameters: - name: _id in: query description: 'The id for the Provenance resource. Format is \:\ (Example: AllergyIntolerance:95ea43f3-1066-4bc7-b224-6c23b985f145).' required: false schema: type: string responses: '200': description: 'Standard Response' content: application/json: schema: properties: 'json object': { description: 'FHIR Json object.', type: object } type: object example: meta: { lastUpdated: '2021-09-14T09:13:51' } resourceType: Bundle type: collection total: 0 link: [{ relation: self, url: 'https://localhost:9300/apis/default/fhir/Provenance' }] '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/metadata: get: tags: - fhir description: 'Returns metadata (ie. CapabilityStatement resource) of the fhir server.' responses: '200': description: 'Return CapabilityStatement resource of the fhir server' /fhir/.well-known/smart-configuration: get: tags: - fhir description: 'Returns smart configuration of the fhir server.' responses: '200': description: 'Return smart configuration of the fhir server' /fhir/$export: get: tags: - fhir description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' responses: '200': description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /fhir/$bulkdata-status: get: tags: - fhir description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' responses: '200': description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] delete: tags: - fhir description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' responses: '200': description: 'The BULK FHIR Exports documentation can be found at https://www.open-emr.org/wiki/index.php/OpenEMR_Wiki_Home_Page#API' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /portal/patient: get: tags: - standard-patient description: 'Returns the patient.' responses: '200': description: 'Standard response' content: application/json: schema: $ref: '#/components/schemas/api_patient_response' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] /portal/patient/encounter: get: tags: - standard-patient description: 'Returns encounters for the patient.' responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] '/portal/patient/encounter/{euuid}': get: tags: - standard-patient description: 'Returns a selected encounter by its uuid.' parameters: - name: euuid in: path description: 'The uuid for the encounter.' required: true schema: type: string responses: '200': $ref: '#/components/responses/standard' '400': $ref: '#/components/responses/badrequest' '401': $ref: '#/components/responses/unauthorized' security: - openemr_auth: [] components: schemas: api_patient_request: description: 'Schema for the patient request' required: - fname - lname - DOB - sex properties: title: description: 'The title of patient.' type: string fname: description: 'The fname of patient.' type: string mname: description: 'The mname of patient.' type: string lname: description: 'The lname of patient.' type: string street: description: 'The street address of patient.' type: string postal_code: description: 'The postal code of patient.' type: string city: description: 'The city of patient.' type: string state: description: 'The state of patient.' type: string country_code: description: 'The country code of patient.' type: string phone_contact: description: 'The phone contact of patient.' type: string DOB: description: 'The DOB of patient.' type: string sex: description: 'The lname of patient.' type: string race: description: 'The race of patient.' type: string ethnicity: description: 'The ethnicity of patient.' type: string type: object example: title: Mr fname: Foo mname: '' lname: Bar street: '456 Tree Lane' postal_code: '08642' city: FooTown state: FL country_code: US phone_contact: 123-456-7890 DOB: '1992-02-02' sex: Male race: '' ethnicity: '' api_patient_response: description: 'Schema for the patient response' properties: validationErrors: description: 'Validation errors.' type: array items: type: object internalErrors: description: 'Internal errors.' type: array items: type: object data: description: 'Returned data.' type: array items: properties: id: description: 'patient id' type: string pid: description: 'patient pid' type: string pubpid: description: 'patient public id' type: string title: description: 'patient title' type: string fname: description: 'patient first name' type: string mname: description: 'patient middle name' type: string lname: description: 'patient last name' type: string ss: description: 'patient social security number' type: string street: description: 'patient street address' type: string postal_code: description: 'patient postal code' type: string city: description: 'patient city' type: string state: description: 'patient state' type: string county: description: 'patient county' type: string country_code: description: 'patient country code' type: string drivers_license: description: 'patient drivers license id' type: string contact_relationship: description: 'patient contact relationship' type: string phone_contact: description: 'patient phone contact' type: string phone_home: description: 'patient home phone' type: string phone_biz: description: 'patient work phone' type: string phone_cell: description: 'patient mobile phone' type: string email: description: 'patient email' type: string DOB: description: 'patient DOB' type: string sex: description: 'patient sex (gender)' type: string race: description: 'patient race' type: string ethnicity: description: 'patient ethnicity' type: string status: description: 'patient status' type: string type: object type: object example: validationErrors: [] error_description: [] data: id: '193' pid: '1' pubpid: '' title: Mr fname: Baz mname: '' lname: Bop ss: '' street: '456 Tree Lane' postal_code: '08642' city: FooTown state: FL county: '' country_code: US drivers_license: '' contact_relationship: '' phone_contact: 123-456-7890 phone_home: '' phone_biz: '' phone_cell: '' email: '' DOB: '1992-02-03' sex: Male race: '' ethnicity: '' status: '' api_encounter_request: description: 'Schema for the encounter request' required: - pc_catid - class_code properties: date: description: 'The date of encounter.' type: string onset_date: description: 'The onset date of encounter.' type: string reason: description: 'The reason of encounter.' type: string facility: description: 'The facility of encounter.' type: string pc_catid: description: 'The pc_catid of encounter.' type: string facility_id: description: 'The facility id of encounter.' type: string billing_facility: description: 'The billing facility id of encounter.' type: string sensitivity: description: 'The sensitivity of encounter.' type: string referral_source: description: 'The referral source of encounter.' type: string pos_code: description: 'The pos_code of encounter.' type: string external_id: description: 'The external id of encounter.' type: string provider_id: description: 'The provider id of encounter.' type: string class_code: description: 'The class_code of encounter.' type: string type: object example: date: '2020-11-10' onset_date: '' reason: 'Pregnancy Test' facility: 'Owerri General Hospital' pc_catid: '5' facility_id: '3' billing_facility: '3' sensitivity: normal referral_source: '' pos_code: '0' external_id: '' provider_id: '1' class_code: AMB api_encounter_response: description: 'Schema for the encounter response' properties: validationErrors: description: 'Validation errors.' type: array items: type: object internalErrors: description: 'Internal errors.' type: array items: type: object data: description: 'Returned data.' type: array items: properties: id: description: 'encounter id' type: string uuid: description: 'encounter uuid' type: string date: description: 'encounter date' type: string reason: description: 'encounter reason' type: string facility: description: 'encounter facility name' type: string facility_id: description: 'encounter facility id name' type: string pid: description: 'encounter for patient pid' type: string onset_date: description: 'encounter onset date' type: string sensitivity: description: 'encounter sensitivity' type: string billing_note: description: 'encounter billing note' type: string pc_catid: description: 'encounter pc_catid' type: string last_level_billed: description: 'encounter last_level_billed' type: string last_level_closed: description: 'encounter last_level_closed' type: string last_stmt_date: description: 'encounter last_stmt_date' type: string stmt_count: description: 'encounter stmt_count' type: string provider_id: description: 'provider id' type: string supervisor_id: description: 'encounter supervisor id' type: string invoice_refno: description: 'encounter invoice_refno' type: string referral_source: description: 'encounter referral source' type: string billing_facility: description: 'encounter billing facility id' type: string external_id: description: 'encounter external id' type: string pos_code: description: 'encounter pos_code' type: string class_code: description: 'encounter class_code' type: string class_title: description: 'encounter class_title' type: string pc_catname: description: 'encounter pc_catname' type: string billing_facility_name: description: 'encounter billing facility name' type: string type: object type: object example: validationErrors: [] error_description: [] data: id: '1' uuid: 90c196f2-51cc-4655-8858-3a80aebff3ef date: '2019-09-14 00:00:00' reason: 'Pregnancy Test' facility: 'Owerri General Hospital' facility_id: '3' pid: '1' onset_date: '2019-04-20 00:00:00' sensitivity: normal billing_note: null pc_catid: '5' last_level_billed: '0' last_level_closed: '0' last_stmt_date: null stmt_count: '0' provider_id: '1' supervisor_id: '0' invoice_refno: '' referral_source: '' billing_facility: '3' external_id: '' pos_code: '0' class_code: AMB class_title: ambulatory pc_catname: 'Office Visit' billing_facility_name: 'Owerri General Hospital' api_vital_request: description: 'Schema for the vital request' properties: bps: description: 'The bps of vitals.' type: string bpd: description: 'The bpd of vitals.' type: string weight: description: 'The weight of vitals. (unit is lb)' type: string height: description: 'The height of vitals. (unit is inches)' type: string temperature: description: 'The temperature of temperature. (unit is F)' type: string temp_method: description: 'The temp_method of vitals.' type: string pulse: description: 'The pulse of vitals.' type: string respiration: description: 'The respiration of vitals.' type: string note: description: 'The note (ie. comments) of vitals.' type: string waist_circ: description: 'The waist circumference of vitals. (unit is inches)' type: string head_circ: description: 'The head circumference of vitals. (unit is inches)' type: string oxygen_saturation: description: 'The oxygen_saturation of vitals.' type: string type: object example: bps: '130' bpd: '80' weight: '220' height: '70' temperature: '98' temp_method: Oral pulse: '60' respiration: '20' note: 'Patient with difficulty standing, which made weight measurement difficult.' waist_circ: '37' head_circ: '22.2' oxygen_saturation: '96' api_soap_note_request: description: 'Schema for the soap_note request' properties: subjective: description: 'The subjective of soap note.' type: string objective: description: 'The objective of soap note.' type: string assessment: description: 'The assessment of soap note.' type: string plan: description: 'The plan of soap note.' type: string type: object example: subjective: 'The patient with mechanical fall and cut finger.' objective: 'The patient with finger laceration on exam.' assessment: 'The patient with finger laceration requiring sutures.' plan: 'Sutured finger laceration.' api_medical_problem_request: description: 'Schema for the medical_problem request' required: - title - begdate properties: title: description: 'The title of medical problem.' type: string begdate: description: 'The beginning date of medical problem.' type: string enddate: description: 'The end date of medical problem.' type: string diagnosis: description: 'The diagnosis of medical problem. In format `:`' type: string type: object example: title: Dermatochalasis begdate: '2010-10-13' enddate: null diagnosis: 'ICD10:H02.839' api_allergy_request: description: 'Schema for the allergy request' required: - title - begdate properties: title: description: 'The title of allergy.' type: string begdate: description: 'The beginning date of allergy.' type: string enddate: description: 'The end date of allergy.' type: string diagnosis: description: 'The diagnosis of allergy. In format `:`' type: string type: object example: title: Iodine begdate: '2010-10-13' enddate: null api_medication_request: description: 'Schema for the medication request' required: - title - begdate properties: title: description: 'The title of medication.' type: string begdate: description: 'The beginning date of medication.' type: string enddate: description: 'The end date of medication.' type: string diagnosis: description: 'The diagnosis of medication. In format `:`' type: string type: object example: title: Norvasc begdate: '2013-04-13' enddate: null api_surgery_request: description: 'Schema for the surgery request' required: - title - begdate properties: title: description: 'The title of surgery.' type: string begdate: description: 'The beginning date of surgery.' type: string enddate: description: 'The end date of surgery.' type: string diagnosis: description: 'The diagnosis of surgery. In format `:`' type: string type: object example: title: Blepharoplasty begdate: '2013-10-14' enddate: null diagnosis: 'CPT4:15823-50' api_dental_issue_request: description: 'Schema for the dental_issue request' required: - title - begdate properties: title: description: 'The title of dental issue.' type: string begdate: description: 'The beginning date of dental issue.' type: string enddate: description: 'The end date of dental issue.' type: string diagnosis: description: 'The diagnosis of dental issue. In format `:`' type: string type: object example: title: Halitosis begdate: '2015-03-17' enddate: null api_insurance_company_request: description: 'Schema for the insurance_company request' required: - name properties: name: description: 'The name of insurance company.' type: string attn: description: 'The attn of insurance company.' type: string cms_id: description: 'The cms id of insurance company.' type: string ins_type_code: description: 'The insurance type code of insurance company. The insurance type code can be found by inspecting the route at (/api/insurance_type).' type: string x12_receiver_id: description: 'The x12 receiver id of insurance company.' type: string x12_default_partner_id: description: 'The x12 default partner id of insurance company.' type: string alt_cms_id: description: 'The alternate cms id of insurance company.' type: string line1: description: 'The line1 address of insurance company.' type: string line2: description: 'The line2 address of insurance company.' type: string city: description: 'The city of insurance company.' type: string state: description: 'The state of insurance company.' type: string zip: description: 'The zip of insurance company.' type: string country: description: 'The country of insurance company.' type: string type: object example: name: 'Cool Insurance Company' attn: null cms_id: null ins_type_code: '2' x12_receiver_id: null x12_default_partner_id: null alt_cms_id: '' line1: '123 Cool Lane' line2: 'Suite 123' city: Cooltown state: CA zip: '12245' country: USA api_insurance_request: description: 'Schema for the insurance request' required: - provider - plan_name - policy_number - group_number - subscriber_fname - subscriber_lname - subscriber_relationship - subscriber_ss - subscriber_DOB - subscriber_street - subscriber_postal_code - subscriber_city - subscriber_state - subscriber_country - subscriber_phone - subscriber_sex - accept_assignment - policy_type properties: provider: description: 'The insurance company id.' type: string plan_name: description: 'The plan name of insurance.' type: string policy_number: description: 'The policy number of insurance.' type: string group_number: description: 'The group number of insurance.' type: string subscriber_lname: description: 'The subscriber last name of insurance.' type: string subscriber_mname: description: 'The subscriber middle name of insurance.' type: string subscriber_fname: description: 'The subscriber first name of insurance.' type: string subscriber_relationship: description: 'The subscriber relationship of insurance.' type: string subscriber_ss: description: 'The subscriber ss number of insurance.' type: string subscriber_DOB: description: 'The subscriber DOB of insurance.' type: string subscriber_street: description: 'The subscriber street address of insurance.' type: string subscriber_postal_code: description: 'The subscriber postal code of insurance.' type: string subscriber_city: description: 'The subscriber city of insurance.' type: string subscriber_state: description: 'The subscriber state of insurance. `state` can be found by querying `resource=/api/list/state`' type: string subscriber_country: description: 'The subscriber country of insurance. `country` can be found by querying `resource=/api/list/country`' type: string subscriber_phone: description: 'The subscriber phone of insurance.' type: string subscriber_employer: description: 'The subscriber employer of insurance.' type: string subscriber_employer_street: description: 'The subscriber employer street of insurance.' type: string subscriber_employer_postal_code: description: 'The subscriber employer postal code of insurance.' type: string subscriber_employer_state: description: 'The subscriber employer state of insurance.' type: string subscriber_employer_country: description: 'The subscriber employer country of insurance.' type: string subscriber_employer_city: description: 'The subscriber employer city of insurance.' type: string copay: description: 'The copay of insurance.' type: string date: description: 'The date of insurance.' type: string subscriber_sex: description: 'The subscriber sex of insurance.' type: string accept_assignment: description: 'The accept_assignment of insurance.' type: string policy_type: description: 'The policy_type of insurance.' type: string type: object example: provider: '33' plan_name: 'Some Plan' policy_number: '12345' group_number: '252412' subscriber_lname: Tester subscriber_mname: Xi subscriber_fname: Foo subscriber_relationship: other subscriber_ss: '234231234' subscriber_DOB: '2018-10-03' subscriber_street: '183 Cool St' subscriber_postal_code: '23418' subscriber_city: Cooltown subscriber_state: AZ subscriber_country: USA subscriber_phone: 234-598-2123 subscriber_employer: 'Some Employer' subscriber_employer_street: '123 Heather Lane' subscriber_employer_postal_code: '23415' subscriber_employer_state: AZ subscriber_employer_country: USA subscriber_employer_city: Cooltown copay: '35' date: '2018-10-15' subscriber_sex: Female accept_assignment: 'TRUE' policy_type: a api_message_request: description: 'Schema for the message request' required: - body - groupname - from - to - title - message_status properties: body: description: 'The body of message.' type: string groupname: description: 'The group name (usually is ''Default'').' type: string from: description: 'The sender of the message.' type: string to: description: 'The recipient of the message.' type: string title: description: 'use an option from resource=/api/list/note_type' type: string message_status: description: 'use an option from resource=/api/list/message_status' type: string type: object example: body: 'Test 456' groupname: Default from: Matthew to: admin title: Other message_status: New api_transaction_request: description: 'Schema for the transaction request' required: - message - groupname - title properties: message: description: 'The message of the transaction.' type: string type: description: 'The type of transaction. Use an option from resource=/api/transaction_type' type: string groupname: description: 'The group name (usually is ''Default'').' type: string referByNpi: description: 'NPI of the person creating the referral.' type: string referToNpi: description: 'NPI of the person getting the referral.' type: string referDiagnosis: description: 'The referral diagnosis.' type: string riskLevel: description: 'The risk level. (Low, Medium, High)' type: string includeVitals: description: 'Are vitals included (0,1)' type: string referralDate: description: 'The date of the referral' type: string authorization: description: 'The authorization for the referral' type: string visits: description: 'The number of vists for the referral' type: string validFrom: description: 'The date the referral is valid from' type: string validThrough: description: 'The date the referral is valid through' type: string type: object example: message: Message type: LBTref groupname: Default referByNpi: '9999999999' referToNpi: '9999999999' referDiagnosis: 'Diag 1' riskLevel: Low includeVitals: '1' referralDate: '2022-01-01' authorization: Auth_123 visits: '1' validFrom: '2022-01-02' validThrough: '2022-01-03' body: 'Reason 1' responses: standard: description: 'Standard Response' content: application/json: schema: properties: validationErrors: description: 'Validation errors.' type: array items: type: object internalErrors: description: 'Internal errors.' type: array items: type: object data: description: 'Returned data.' type: array items: type: object type: object example: validationErrors: [] error_description: [] data: [] badrequest: description: 'Bad Request' content: application/json: schema: properties: validationErrors: description: 'Validation errors.' type: object type: object example: validationErrors: _id: 'The search field argument was invalid, improperly formatted, or could not be parsed. Inner message: UUID columns must be a valid UUID string' unauthorized: description: Unauthorized content: application/json: schema: properties: error: description: 'The error.' type: string error_description: description: 'The description of the error.' type: string hint: description: 'More specific information on the error.' type: string message: description: 'Message regarding the error.' type: string type: object example: error: access_denied error_description: 'The resource owner or authorization server denied the request.' hint: 'Missing "Authorization" header' message: 'The resource owner or authorization server denied the request.' uuidnotfound: description: 'Not Found' content: application/json: schema: properties: empty: description: empty type: object type: object example: [] securitySchemes: openemr_auth: type: oauth2 flows: authorizationCode: authorizationUrl: /oauth2/default/authorize tokenUrl: /oauth2/default/token refreshUrl: /oauth2/default/token scopes: openid: 'Generic mandatory scope' offline_access: 'Will signal server to provide a refresh token' launch/patient: 'Will provide a patient selector when logging in as an OpenEMR user (required for testing patient/* scopes in swagger if not logging in as a patient)' 'api:fhir': 'FHIR R4 API' patient/AllergyIntolerance.read: 'Read allergy intolerance resources for the current patient (api:fhir)' patient/CarePlan.read: 'Read care plan resources for the current patient (api:fhir)' patient/CareTeam.read: 'Read care team resources for the current patient (api:fhir)' patient/Condition.read: 'Read condition resources for the current patient (api:fhir)' patient/Coverage.read: 'Read coverage resources for the current patient (api:fhir)' patient/Device.read: 'Read device resources for the current patient (api:fhir)' patient/DiagnosticReport.read: 'Read diagnostic report resources for the current patient (api:fhir)' patient/Document.read: 'Read document resources for the current patient (api:fhir)' patient/DocumentReference.read: 'Read document reference resources for the current patient (api:fhir)' patient/DocumentReference.$docref: 'Generate a document for the current patient or returns the most current Clinical Summary of Care Document (CCD)' patient/Encounter.read: 'Read encounter resources for the current patient (api:fhir)' patient/Goal.read: 'Read goal resources for the current patient (api:fhir)' patient/Immunization.read: 'Read immunization resources for the current patient (api:fhir)' patient/Location.read: 'Read location resources for the current patient (api:fhir)' patient/Medication.read: 'Read medication resources for the current patient (api:fhir)' patient/MedicationRequest.read: 'Read medication request resources for the current patient (api:fhir)' patient/Observation.read: 'Read observation resources for the current patient (api:fhir)' patient/Organization.read: 'Read organization resources for the current patient (api:fhir)' patient/Patient.read: 'Read patient resource for the current patient (api:fhir)' patient/Person.read: 'Read person resources for the current patient (api:fhir)' patient/Practitioner.read: 'Read practitioner resources for the current patient (api:fhir)' patient/Procedure.read: 'Read procedure resources for the current patient (api:fhir)' patient/Provenance.read: 'Read provenance resources for the current patient (api:fhir)' system/AllergyIntolerance.read: 'Read all allergy intolerance resources in the system (api:fhir)' system/CarePlan.read: 'Read all care plan resources in the system (api:fhir)' system/CareTeam.read: 'Read all care team resources in the system (api:fhir)' system/Condition.read: 'Read all condition resources in the system (api:fhir)' system/Coverage.read: 'Read all coverage resources in the system (api:fhir)' system/Device.read: 'Read all device resources in the system (api:fhir)' system/DiagnosticReport.read: 'Read all diagnostic report resources in the system (api:fhir)' system/Document.read: 'Read all document resources in the system (api:fhir)' system/DocumentReference.read: 'Read all document reference resources in the system (api:fhir)' system/DocumentReference.$docref: 'Generate a document for any patient in the system or returns the most current Clinical Summary of Care Document (CCD)' system/Encounter.read: 'Read all encounter resources in the system (api:fhir)' system/Goal.read: 'Read all goal resources in the system (api:fhir)' system/Group.read: 'Read all group resources in the system (api:fhir)' system/Immunization.read: 'Read all immunization resources in the system (api:fhir)' system/Location.read: 'Read all location resources in the system (api:fhir)' system/Medication.read: 'Read all medication resources in the system (api:fhir)' system/MedicationRequest.read: 'Read all medication request resources in the system (api:fhir)' system/Observation.read: 'Read all observation resources in the system (api:fhir)' system/Organization.read: 'Read all organization resources in the system (api:fhir)' system/Patient.read: 'Read all patient resources in the system (api:fhir)' system/Person.read: 'Read all person resources in the system (api:fhir)' system/Practitioner.read: 'Read all practitioner resources in the system (api:fhir)' system/PractitionerRole.read: 'Read all practitioner role resources in the system (api:fhir)' system/Procedure.read: 'Read all procedure resources in the system (api:fhir)' system/Provenance.read: 'Read all provenance resources in the system (api:fhir)' user/AllergyIntolerance.read: 'Read all allergy intolerance resources the user has access to (api:fhir)' user/CarePlan.read: 'Read all care plan resources the user has access to (api:fhir)' user/CareTeam.read: 'Read all care team resources the user has access to (api:fhir)' user/Condition.read: 'Read all condition resources the user has access to (api:fhir)' user/Coverage.read: 'Read all coverage resources the user has access to (api:fhir)' user/Device.read: 'Read all device resources the user has access to (api:fhir)' user/DiagnosticReport.read: 'Read all diagnostic report resources the user has access to (api:fhir)' user/Document.read: 'Read all documents the user has access to (api:fhir)' user/DocumentReference.read: 'Read all document reference resources the user has access to (api:fhir)' user/DocumentReference.$docref: 'Generate a document for any patient the user has access to or returns the most current Clinical Summary of Care Document (CCD) (api:fhir)' user/Encounter.read: 'Read all encounter resources the user has access to (api:fhir)' user/Goal.read: 'Read all goal resources the user has access to (api:fhir)' user/Immunization.read: 'Read all immunization resources the user has access to (api:fhir)' user/Location.read: 'Read all location resources the user has access to (api:fhir)' user/Medication.read: 'Read all medication resources the user has access to (api:fhir)' user/MedicationRequest.read: 'Read all medication request resources the user has access to (api:fhir)' user/Observation.read: 'Read all observation resources the user has access to (api:fhir)' user/Organization.read: 'Read all organization resources the user has access to (api:fhir)' user/Organization.write: 'Write all organization resources the user has access to (api:fhir)' user/Patient.read: 'Read all patient resources the user has access to (api:fhir)' user/Patient.write: 'Write all patient resources the user has access to (api:fhir)' user/Person.read: 'Read all person resources the user has access to (api:fhir)' user/Practitioner.read: 'Read all practitioner resources the user has access to (api:fhir)' user/Practitioner.write: 'Write all practitioner resources the user has access to (api:fhir)' user/PractitionerRole.read: 'Read all practitioner role resources the user has access to (api:fhir)' user/Procedure.read: 'Read all procedure resources the user has access to (api:fhir)' user/Provenance.read: 'Read all provenance resources the user has access to (api:fhir)' 'api:oemr': 'Standard OpenEMR API' user/allergy.read: 'Read allergies the user has access to (api:oemr)' user/allergy.write: 'Write allergies the user has access to for (api:oemr)' user/appointment.read: 'Read appointments the user has access to (api:oemr)' user/appointment.write: 'Write appointments the user has access to for (api:oemr)' user/dental_issue.read: 'Read dental issues the user has access to (api:oemr)' user/dental_issue.write: 'Write dental issues the user has access to (api:oemr)' user/document.read: 'Read documents the user has access to (api:oemr)' user/document.write: 'Write documents the user has access to (api:oemr)' user/drug.read: 'Read drugs the user has access to (api:oemr)' user/encounter.read: 'Read encounters the user has access to (api:oemr)' user/encounter.write: 'Write encounters the user has access to (api:oemr)' user/facility.read: 'Read facilities the user has access to (api:oemr)' user/facility.write: 'Write facilities the user has access to (api:oemr)' user/immunization.read: 'Read immunizations the user has access to (api:oemr)' user/insurance.read: 'Read insurances the user has access to (api:oemr)' user/insurance.write: 'Write insurances the user has access to (api:oemr)' user/insurance_company.read: 'Read insurance companies the user has access to (api:oemr)' user/insurance_company.write: 'Write insurance companies the user has access to (api:oemr)' user/insurance_type.read: 'Read insurance types the user has access to (api:oemr)' user/list.read: 'Read lists the user has access to (api:oemr)' user/medical_problem.read: 'Read medical problems the user has access to (api:oemr)' user/medical_problem.write: 'Write medical problems the user has access to (api:oemr)' user/medication.read: 'Read medications the user has access to (api:oemr)' user/medication.write: 'Write medications the user has access to (api:oemr)' user/message.write: 'Read messages the user has access to (api:oemr)' user/patient.read: 'Read patients the user has access to (api:oemr)' user/patient.write: 'Write patients the user has access to (api:oemr)' user/practitioner.read: 'Read practitioners the user has access to (api:oemr)' user/practitioner.write: 'Write practitioners the user has access to (api:oemr)' user/prescription.read: 'Read prescriptions the user has access to (api:oemr)' user/procedure.read: 'Read procedures the user has access to (api:oemr)' user/soap_note.read: 'Read soap notes the user has access to (api:oemr)' user/soap_note.write: 'Write soap notes the user has access to (api:oemr)' user/surgery.read: 'Read surgeries the user has access to (api:oemr)' user/surgery.write: 'Write surgeries the user has access to (api:oemr)' user/transaction.read: 'Read transactions the user has access to (api:oemr)' user/transaction.write: 'Write transactions the user has access to (api:oemr)' user/vital.read: 'Read vitals the user has access to (api:oemr)' user/vital.write: 'Write vitals the user has access to (api:oemr)' 'api:port': 'Standard Patient Portal OpenEMR API' patient/encounter.read: 'Read encounters the patient has access to (api:port)' patient/patient.read: 'Write encounters the patient has access to (api:port)' tags: - name: fhir description: 'FHIR R4 API' - name: standard description: 'Standard OpenEMR API' - name: standard-patient description: 'Standard Patient Portal OpenEMR API'