openapi: 3.2.0 info: title: Fhir Provider Directory Healthcare Service API description: "\n**Provider Directory API for CMS 9115-F**\n\nThe Provider Directory API provides access to provider information. To get started, a third-party developer must request an API key.\n\n**1. Get Your API Key** Request an API key by filling out the form at: [Logic Manager Form](https://dentaquest.logicmanager.com/incidents/?t=1241&p=215&k=F0E3BD92F157F9B73EDE82834286E7CEA4044134B39D92AC3EE7E56392194241). Be sure to select \"Provider Directory\" from the API dropdown menu.\n\n**2. Make Requests** Once you receive your key, include it in the `Ocp-Apim-Subscription-Key` header for all API calls to your requests.\n\n### **API Standards and Conformance**\n\nThis API conforms to the following standards and implementation specifications:\n\n- **FHIR Version:** `4.0.1` (R4)\n \n- **Implementation Guide:** `HL7 Da Vinci PDex Plan-Net Implementation Guide Version 1.1.0`\n \n\n### **Exception Handling**\n\nThe API uses standard HTTP status codes to indicate the success or failure of a request. In the event of an error (HTTP status codes `4xx` or `5xx`), for example an invalid API key (`403 Forbidden`) or a malformed request (`400 Bad Request`). The response body will also contain a FHIR `OperationOutcome` resource. This resource provides detailed, structured information about the error, including severity, error codes, and human-readable diagnostics to assist with troubleshooting.\n\n\n\n### **Exception Response**\n| HTTP Status | Response | Reason |\n| ----------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| **400** | `Bad Request` | The request could not be understood by the server due to malformed syntax (e.g., an invalid parameter). |\n| **401** | `Unauthorized` | The request lacks valid authentication credentials. This may occur if the JWT token is missing, expired, or invalid. |\n| **403** | `Forbidden` | The server understood the request, but refuses to authorize it. This may occur if the member has not granted the application access. |\n| **404** | `Not Found` | The requested FHIR resource (e.g., a specific Patient or Coverage record) does not exist. |\n| **500** | `Internal Server Error` | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n\n" version: '1.0' servers: - url: https://api.dentaquest.com/FhirProviderDirectory - url: https://api.deltadentalma.com/FhirProviderDirectory security: - apiKeyHeader: [] - apiKeyQuery: [] tags: - name: HealthcareService paths: /HealthcareService: get: summary: /HealthcareService - GET description: /HealthcareService - GET operationId: get-healthcareservice parameters: - name: coverage-area in: query description: Location(s) service is intended for/available to schema: type: string - name: characteristic in: query description: One of the HealthcareService's characteristics schema: type: string - name: organization in: query description: The organization that provides this Healthcare Service schema: type: string - name: service-category in: query description: Service Category of the Healthcare Service schema: type: string - name: program in: query description: One of the Programs supported by this HealthcareService schema: type: string - name: location in: query description: The location of the Healthcare Service schema: type: string - name: active in: query description: The Healthcare Service is currently marked as active schema: type: string - name: _id in: query description: Logical id of this artifact schema: type: string - name: _profile in: query description: Profiles this resource claims to conform to schema: type: string - name: service-type in: query description: The type of service provided by this healthcare service schema: type: string - name: _lastUpdated in: query description: Format - date (as full-date in RFC3339). Format - date (as full-date in RFC3339). When the resource version last changed schema: type: string format: date - name: _security in: query description: Security Labels applied to this resource schema: type: string - name: specialty in: query description: The specialty of the service provided by this healthcare service schema: type: string - name: _source in: query description: Identifies where the resource comes from schema: type: string - name: endpoint in: query description: Technical endpoints providing access to electronic services operated for the healthcare service schema: type: string - name: name in: query description: A portion of the Healthcare service name schema: type: string - name: _tag in: query description: Tags applied to this resource schema: type: string - name: identifier in: query description: External identifiers for this item schema: type: string - name: _format in: query description: Output formatting schema: type: string responses: '200': description: Success tags: - HealthcareService /HealthcareService/{id}: get: summary: /HealthcareService/{id} - GET description: /HealthcareService/{id} - GET operationId: get-healthcareservice-id parameters: - name: id in: path description: id of resource required: true schema: type: string responses: '200': description: Success tags: - HealthcareService /HealthcareService/{id}/_history/{vid}: get: summary: /HealthcareService/{id}/_history/{vid} - GET description: /HealthcareService/{id}/_history/{vid} - GET operationId: get-healthcareservice-id-_history-vid parameters: - name: id in: path description: id of resource required: true schema: type: string - name: vid in: path description: version id of resource required: true schema: type: string responses: '200': description: Success tags: - HealthcareService /HealthcareService/{id}/_history: get: summary: /HealthcareService/{id}/_history - GET description: /HealthcareService/{id}/_history - GET operationId: get-healthcareservice-id-_history parameters: - name: id in: path description: id of resource required: true schema: type: string - name: _count in: query description: number to return schema: type: string - name: _since in: query description: how far back schema: type: string responses: '200': description: Success tags: - HealthcareService /HealthcareService/_history: get: summary: /HealthcareService/_history - GET description: /HealthcareService/_history - GET operationId: get-healthcareservice-_history parameters: - name: _count in: query description: number to return schema: type: string - name: _since in: query description: how far back schema: type: string responses: '200': description: Success tags: - HealthcareService components: securitySchemes: apiKeyHeader: type: apiKey name: Ocp-Apim-Subscription-Key in: header apiKeyQuery: type: apiKey name: subscription-key in: query