openapi: 3.2.0 info: title: Omni Data API description: API specification for Omni's endpoints. Fast Pages Entities Schema Version - (4.2.2) version: 2.21.0 license: name: None url: None servers: - url: https://dev${brand}omni.azurewebsites.net description: Dev Server - url: https://qa${brand}omni.azurewebsites.net description: QA Server - url: https://uat${brand}omni.azurewebsites.net description: Test Server - url: https://${brand}omni.azurewebsites.net description: Prod Server security: - {} tags: - name: OmniData paths: /api/OmniData/{version}: get: operationId: Get_Data summary: Omni Data description: Retrieve clinician or department data using their identifiers. parameters: - name: version in: path required: false schema: description: '(Optional) The version of the API ' type: string const: 2.21.0 - name: allLocations in: query schema: $ref: '#/components/schemas/allLocations' - $ref: '#/components/parameters/BrandParam' - name: departmentIds in: query schema: $ref: '#/components/schemas/departmentIds' - name: departmentUrls in: query schema: $ref: '#/components/schemas/departmentUrls' - name: ids in: query schema: $ref: '#/components/schemas/ids' - name: npis in: query schema: $ref: '#/components/schemas/npis' - name: select in: query schema: $ref: '#/components/schemas/select' - name: urls in: query schema: $ref: '#/components/schemas/urls' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/OmniDataSuccessResponse' '400': description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' default: description: Failure tests the mettle of heart, brain and body. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' tags: - OmniData components: schemas: clinicianFastPages: $id: https://dexcarehealth.com/schemas/fastPages/clinicianFastPages $schema: https://json-schema.org/draft/2020-12/schema description: Fast Pages Clinician dexProcessingDirectives: - typescript properties: '@search.distance': description: "This provides details regarding how far the user is from the clinician.\n\n@example\n```\n{\n\t miles: 12.199344228250027, \n\t type: \"absolute\"\n}\n```\n\nscope - `OmniSearch` `OmniData`" properties: miles: description: 'The distance in miles the user is from the clinician @example `12.199344228250027` scope - `OmniSearch` `OmniData`' example: 12.199344228250027 type: number type: description: "The type of distance measurement.\n\n Values:\n\n`\"absolute\"` - the exact amount of miles from the user\n\n`\"neighborhood, city, county, zip\"` - determines the geographical distance from the user. ex: `\"zip\"` is returned, the location result is within the same postal code\n\n@example\n`\"absolute\"`\n\nscope - `OmniSearch` `OmniData`" example: absolute type: string tags: - fastPages type: object '@search.features': description: "This provides more detail about the relevance score at the field level associated with the returned result.\n\n @link: https://learn.microsoft.com/en-us/azure/search/index-similarity-and-scoring#featuresmode-parameter-preview \n\n@example\n ```\n {\n\t specialties.name: {\n\t\tuniqueTokenMatches: 2, \n\t\tsimilarityScore: 13.0041493, \n\t\ttermFrequency: 2\n\t}\n}\n``` \n\nscope - `OmniSearch`" properties: uniqueTokenMatches: description: Number of unique tokens found in the field example: 2 type: number similarityScore: description: Similarity score, or a measure of how similar the content of the field is, relative to the query term example: 13.0041493 type: number termFrequency: description: Term frequency, or the number of times the query term was found in the field example: 2 type: number tags: - fastPages type: object '@search.highlights': additionalProperties: items: type: string type: array description: "This includes bolded matches to the search.\n\n @link: https://learn.microsoft.com/en-us/azure/search/search-pagination-page-layout#hit-highlighting \n\n@example\n ```\n{\n\t specialties.name: [\n\t\t 'Family Medicine',\n\t\t 'Internal Medicine'\n\t ]\n}\n``` \n\nscope - `OmniSearch`" example: specialties.name: - Family Medicine - Internal Medicine tags: - fastPages type: object '@search.score': description: "This is the relevance score associated with the returned result.\n\n @link: https://learn.microsoft.com/en-us/azure/search/search-query-odata-search-score-function \n\n@example\n `4360.5723` \n\nscope - `OmniSearch`" example: '4360.5723' tags: - fastPages type: string adhoc: description: 'Adhoc properties for the clinician. These will be key/value pairs of strings. ``` scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`' tags: - ingest - omni - fastPages type: object agesSeen: description: "Age groups seen by the clinician.\n\n@example\n ```\n[\n \"Geriatrics\",\n \"Adults\"\n]\n``` \nscope - `OmniData`" example: - Geriatrics - Adults items: type: string nullable: true tags: - ingest - omni - fastPages type: array badges: description: "Badges for displaying applied facet filters on search page clinician cards.\n\n@example\n```\n[\n \"Gender: Male\",\n \"Languages: English\",\n \"Specialties: Orthopedic Surgery\"\n]\n```\nscope - `OmniSearch`" example: - 'Gender: Male' - 'Languages: English' - 'Specialties: Orthopedic Surgery' items: type: string tags: - omni - fastPages type: array bio: description: "Biography of clinician. string or html.\n\n@example\n```\"
Located in Seattle, WA, University Physicians ENT Seattle is a specialty practice dedicated to helping you get better - and stay well.
"``` scope - `OmniSearch` `OmniData`' example: 'Located in Seattle, WA, University Physicians ENT Seattle is a specialty practice dedicated to helping you get better - and stay well.
' nullable: true tags: - ingest - omni - fastPages type: string dexcareBuildsPage: description: 'Flag to determine if DexCare should build a page for this location. @example ```true``` scope - `OmniData`' example: true tags: - ingest - omni - fastPages type: boolean displayName: description: 'Display name of the location. @example ```"University Health Medical Pavillion"``` scope - `OmniSearch` `OmniData`' example: University Health Medical Pavillion tags: - ingest - omni - fastPages type: string extended: description: 'Extended properties for the clinician. These will be described by a customer defined schema. ``` scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`' tags: - ingest - omni - fastPages type: object fax: description: 'Fax number associated with the location. @example ```"+16175551212"``` scope - `OmniSearch` `OmniData`' example: '+16175551212' nullable: true pattern: ^\+?[1-9][0-9]{1,14}$ tags: - ingest - omni - fastPages type: string googlePlaceUrl: description: 'Google Maps location URL. Provides a better view of the location in Google Maps. @example ```"https://www.google.com/maps/place/University+Health+Medical+Group/@42.9202749,-89.2107675,17z/data=!....."``` scope - `OmniData`' example: https://www.google.com/maps/place/University+Health+Medical+Group/@42.9202749,-89.2107675,17z/data=!..... nullable: true tags: - ingest - omni - fastPages type: string hours: description: "\nOpening and closing times for a week \n\n@examples \n```\n// M-F Primary Care Clinic \n{ \n mon: { \n open: \"07:00\", \n close: \"18:00\", \n }, \n tue: {... same as mon}, \n wed: {... same as mon}, \n thu: {... same as mon}, \n fri: { \n open: \"07:00\", \n close: \"14:00\", \n } \n} \n \n// ER \n{\n \"custom\": \"Closed on Christmas\",\n \"fri\": {\n \"open24Hours\": true\n },\n \"mon\": {\n \"open24Hours\": true\n },\n \"sat\": {\n \"open24Hours\": true\n },\n \"sun\": {\n \"open24Hours\": true\n },\n \"thu\": {\n \"open24Hours\": true\n },\n \"tue\": {\n \"open24Hours\": true\n },\n \"wed\": {\n \"open24Hours\": true\n }\n} \n \n// Custom Message \n{ \n custom: \"By appointment only.\", \n} \n```\n\nscope - `OmniSearch` `OmniData`" properties: custom: description: "Field to populate during holidays or inclement weather as needed, eg. 'Closed on Christmas' or 'Office closure on Jan 16th due to extreme weather'.\n\n@example\n```\"Closed on Christmas\"``` \n\nscope - `OmniSearch` `OmniData`" example: Closed on Christmas type: string fri: $ref: '#/components/schemas/hoursDayFastPages' mon: $ref: '#/components/schemas/hoursDayFastPages' sat: $ref: '#/components/schemas/hoursDayFastPages' sun: $ref: '#/components/schemas/hoursDayFastPages' thu: $ref: '#/components/schemas/hoursDayFastPages' tue: $ref: '#/components/schemas/hoursDayFastPages' wed: $ref: '#/components/schemas/hoursDayFastPages' tags: - ingest - omni - fastPages type: object id: description: "Unique identifier for the location \n\nscope - `OmniSearch` `OmniData`" example: 123456abcd pattern: ^(TEMP-)?[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ tags: - omni - fastPages type: string imageUrl: description: 'URL where the location''s image is stored. Full url with production origin. @example ```"https://www.universityhealth.com/photos/200/location-2-1023458890.jpg"``` scope - `OmniSearch` `OmniData`' example: https://www.universityhealth.com/photos/200/location-2-1023458890.jpg format: uri nullable: true tags: - ingest - omni - fastPages type: string pageDescription: description: 'SEO page description. meta[name=''description''] tag content @example ```"Ear, Nose and Throat (ENT) Clinic in Seattle. ENT is a specialty practice dedicated to helping you get better and stay well"``` scope - `OmniSearch` `OmniData`' example: Ear, Nose and Throat (ENT) Clinic in Seattle. ENT is a specialty practice dedicated to helping you get better and stay well nullable: true tags: - ingest - omni - fastPages type: string pageTitle: description: 'SEO title. title tag content. String visible in the browser''s tab @example ```"Ear, Nose and Throat (ENT) Clinic in Seattle"``` scope - `OmniData`' example: Ear, Nose and Throat (ENT) Clinic in Seattle nullable: true tags: - ingest - omni - fastPages type: string phone: $ref: '#/components/schemas/phoneNumberFastPages' tags: - ingest - omni - fastPages policies: description: "List of location's policy documents or resource links\n\n@example\n```\n[\n {\n \"name\": \"Over-the-Counter (OTC) Medication Prescription Request Form\",\n \"url\": \"https://www.universityhealth.com/UHealth/media/Documents/Locations/Non-Hospital/otc-medication-prescription-form.pdf\"\n }\n]\n```\n\nscope - `OmniData`" example: - name: Over-the-Counter (OTC) Medication Prescription Request Form url: https://www.universityhealth.com/UHealth/media/Documents/Locations/Non-Hospital/otc-medication-prescription-form.pdf items: properties: name: description: 'Pre-visit forms such as consent forms. @example ```"Over-the-Counter (OTC) Medication Prescription Request Form"``` scope - `OmniData`' example: Over-the-Counter (OTC) Medication Prescription Request Form type: string url: description: 'URL where the form lives. @example ```"/UHealth/media/Documents/Locations/Non-Hospital/otc-medication-prescription-form.pdf"``` scope - `OmniData`' example: /UHealth/media/Documents/Locations/Non-Hospital/otc-medication-prescription-form.pdf type: string required: - name type: object tags: - ingest - omni - fastPages type: array resultType: const: location description: "Result type is a location \n\nscope - `OmniSearch` `OmniData`" tags: - omni - fastPages type: string services: description: "Services offered at the location.\n\n@example\n```\n[\n {\n \"name\": \"Optometry\",\n \"url\": \"https://www.universityhealth.com/services/eye-care/optometry\"\n }\n]\n```\n\nscope - `OmniData`" example: - name: Optometry url: https://www.universityhealth.com/services/eye-care/optometry items: properties: name: description: 'Name of service practiced at this location. @example ```"Optometry"``` scope - `OmniData`' example: Optometry type: string url: description: 'URL where more information on the service can be found. @example ```"https://www.universityhealth.com/services/eye-care/optometry"``` scope - `OmniData`' example: https://www.universityhealth.com/services/eye-care/optometry type: string required: - name type: object tags: - ingest - omni - fastPages type: array tier: description: 'Used as a weight for the location search algorithm. 1 ranks higher than 2. @example ```1```' example: 1 default: 1 tags: - ingest - omni - fastPages type: integer timezone: description: 'Timezone the location is located in. - IANA/Olson format @examples "America/Adak", "America/Anchorage", "America/Boise", "America/Chicago", "America/Denver", "America/Detroit", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Los_Angeles", "America/Menominee", "America/Metlakatla", "America/New_York", "America/Nome", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem" @example ```"America/Los_Angeles"``` scope - `OmniSearch` `OmniData`' example: America/Los_Angeles nullable: true pattern: ^\w[\w_\-\+/]+$ tags: - ingest - omni - fastPages type: string url: description: "URL where the location's page is stored. Full url with production origin. \n Mixed-case urls are supported. Pages will be 301 redirected if browser path characters match but the casing doesn't.\n\n@example\n```\"https://www.universityhealth.com/Locations/urgent-care-teasley-denton\"```\n\nscope - `OmniSearch` `OmniData`" example: https://www.universityhealth.com/Locations/urgent-care-teasley-denton format: uri tags: - ingest - omni - fastPages type: string version: type: string const: 5.3.0 required: - address - brandName - dexcareBuildsPage - displayName - id - resultType - url tags: - ingest - omni - fastPages title: locationFastPages type: object unevaluatedProperties: false ErrorResponse: description: Error response properties: error: description: Reason for the failure. type: string errorData: description: (Optional) Additional error details, if available. type: object required: - error npis: description: A list of npis to lookup, separated by commas. Equivalent to passing the ids for the clinicians with those npis. items: type: string type: array cmsContent: $id: https://dexcarehealth.com/schemas/fastPages/cmsContentFastPages $schema: https://json-schema.org/draft/2020-12/schema description: "Content Management System Sections \n\nscope - `OmniSearch` `OmniData`" dexProcessingDirectives: - typescript properties: pageId: description: "Content Management System Page ID\n\n@example\n```\"1234abc\"``` \n\nscope - `OmniSearch` `OmniData`" example: 1234abc tags: - ingest - omni - fastPages type: string sections: description: "Content Management Sections in the order they will be displayed on the page. Supports HTML String format. HTML is sanitized by ingest process. \n\nscope - `OmniData`" items: properties: body: description: 'Body of page Section. HTML String. @example ```"Can I get a COVID-19 test at ..."```
scope - `OmniData`'
example: Can I get a COVID-19 test at ...
type: string
title:
description: "Title of page section. HTML String.\n\n@example\n``` Located in Seattle, WA, University Physicians ENT Seattle is a specialty practice dedicated to helping you get better - and stay well. Located in Seattle, WA, University Physicians ENT Seattle is a specialty practice dedicated to helping you get better - and stay well.FAQ: Quick Answers About University Health Clinics
``` \n\nscope - `OmniData`"
example: 'FAQ: Quick Answers About University Health Clinics
'
type: string
type:
description: "Type of page section.\n- `accordion` is a collapsable section.\n- `crossSell` is a cross sell panel positioned below the primary care tile.\n- `section` is a title followed by the body. \n\n@example\n```\"accordion\"```\n\nscope - `OmniData`"
enum:
- accordion
- crossSell
- section
example: accordion
type: string
required:
- type
type: object
tags:
- ingest
- omni
- fastPages
type: array
version:
type: string
const: 2.0.0
required:
- pageId
title: cmsContentFastPages
type: object
unevaluatedProperties: false
businessUnitFastPages:
$id: https://dexcarehealth.com/schemas/fastPages/businessUnitFastPages
$schema: https://json-schema.org/draft/2020-12/schema
description: 'Business Unit
scope - `OmniSearch` `OmniData`'
dexProcessingDirectives:
- typescript
properties:
name:
description: 'Business Unit Name.
@example
```"University Health"```
scope - `OmniSearch` `OmniData`'
example: University Health
tags:
- ingest
- omni
- fastPages
type: string
version:
type: string
const: 2.0.0
required:
- name
title: businessUnitFastPages
type: object
unevaluatedProperties: false
ids:
description: A list of ids to lookup, separated by commas. Use this parameter if possible since it does not require an intermediate lookup; other parameters will be slower and may have to wait for the intermediate cache to refresh.
items:
type: string
type: array
departmentFastPages:
$id: https://dexcarehealth.com/schemas/fastPages/departmentFastPages
$schema: https://json-schema.org/draft/2020-12/schema
description: Fast Pages Department
dexProcessingDirectives:
- typescript
properties:
'@search.distance':
description: "This provides details regarding how far the user is from the department.\n\n@example\n```\n{\n\t miles: 12.199344228250027, \n\t type: \"absolute\"\n}\n```\n\nscope - `OmniSearch` `OmniData`"
properties:
miles:
description: 'The distance in miles the user is from the department
@example
`12.199344228250027`
scope - `OmniSearch` `OmniData`'
example: 12.199344228250027
type: number
type:
description: "The type of distance measurement.\n\n Values:\n\n`\"absolute\"` - the exact amount of miles from the user\n\n`\"neighborhood, city, county, zip\"` - determines the geographical distance from the user. ex: `\"zip\"` is returned, the location result is within the same postal code\n\n@example\n`\"absolute\"`\n\nscope - `OmniSearch` `OmniData`"
example: absolute
type: string
tags:
- fastPages
type: object
'@search.features':
description: "This provides more detail about the relevance score at the field level associated with the returned result.\n\n @link: https://learn.microsoft.com/en-us/azure/search/index-similarity-and-scoring#featuresmode-parameter-preview \n\n@example\n ```\n {\n\t specialties.name: {\n\t\tuniqueTokenMatches: 2, \n\t\tsimilarityScore: 13.0041493, \n\t\ttermFrequency: 2\n\t}\n}\n``` \n\nscope - `OmniSearch`"
properties:
uniqueTokenMatches:
description: Number of unique tokens found in the field
example: 2
type: number
similarityScore:
description: Similarity score, or a measure of how similar the content of the field is, relative to the query term
example: 13.0041493
type: number
termFrequency:
description: Term frequency, or the number of times the query term was found in the field
example: 2
type: number
tags:
- fastPages
type: object
'@search.highlights':
additionalProperties:
items:
type: string
type: array
description: "This includes bolded matches to the search.\n\n @link: https://learn.microsoft.com/en-us/azure/search/search-pagination-page-layout#hit-highlighting \n\n@example\n ```\n{\n\t specialties.name: [\n\t\t 'Family Medicine',\n\t\t 'Internal Medicine'\n\t ]\n}\n``` \n\nscope - `OmniSearch`"
example:
specialties.name:
- Family Medicine
- Internal Medicine
tags:
- fastPages
type: object
'@search.score':
description: "This is the relevance score associated with the returned result.\n\n @link: https://learn.microsoft.com/en-us/azure/search/search-query-odata-search-score-function \n\n@example\n `4360.5723` \n\nscope - `OmniSearch`"
example: '4360.5723'
tags:
- fastPages
type: string
accreditations:
description: 'Accreditations or accolades associated with the department.
@example
```"
"```
scope - `OmniData`'
example: '
'
nullable: true
tags:
- ingest
- omni
- fastPages
type: string
address:
description: "Department Address \n\nscope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`"
properties:
addressLine1:
description: 'Street number where the department resides.
@example
```"822 Industrial Boulevard"```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
example: 822 Industrial Boulevard
pattern: ^.+$
type: string
addressLine2:
description: 'Secondary street number where the department resides. Such as units, apt, suite, etc.
@example
```"Suite 100"```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
example: Suite 100
type: string
city:
description: 'City where the department resides.
@example
```"Ellijay"```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
example: Ellijay
pattern: ^.+$
type: string
country:
description: 'Country where the department resides.
@example
```"US"```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
example: US
pattern: ^.+$
type: string
county:
description: 'County where the department resides.
@example
```"Gilmer County"```
scope - `OmniSearch` `OmniSearchNested`'
example: Gilmer County
pattern: ^.+$
type: string
latitude:
description: 'Latitude of the department
@example
```33.79267```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
example: 33.79267
type: number
longitude:
description: 'Longitude of the department.
@example
```-84.39556```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
example: -84.39556
type: number
postalCode:
description: 'Postal Code or Zip code where the department resides.
@example
```"30540"```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
example: '30540'
type: string
state:
description: 'Region or state where the department resides. This is alpha codes such as ''WI'' for Wisconsin.
@example
```"GA"```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
example: GA
pattern: ^.+$
type: string
required:
- addressLine1
- city
- country
- postalCode
- state
tags:
- ingest
- omni
- fastPages
type: object
adhoc:
description: 'Adhoc properties for the clinician. These will be key/value pairs of strings. ```
scope - `OmniSearch` `OmniData` `OmniSearchNested` `OmniDataNested`'
tags:
- ingest
- omni
- fastPages
type: object
badges:
description: "Badges for displaying applied facet filters on search page department cards.\n\n@example\n\n```\n[\n \"Gender: Male\",\n \"Languages: English\",\n \"Specialties: Orthopedic Surgery\"\n]\n```\n\nscope - `OmniSearch`"
example:
- 'Gender: Male'
- 'Languages: English'
- 'Specialties: Orthopedic Surgery'
items:
type: string
tags:
- omni
- fastPages
type: array
banner:
description: 'Banner to display on the top of a department''s web page.
@example
```"Ear, Nose and Throat (ENT) Care in Seattle
\r\n\r\nEar, Nose and Throat (ENT) Care in Seattle