General Purpose R4 Supported Extensions
Overview
This page documents the FHIR extensions supported by the Netsmart General Purpose R4 API. Extensions provide additional data elements beyond the base FHIR specification to support specific healthcare workflows and data requirements.
Important: The extensions listed below are based on the current CapabilityStatement. Always validate extension support by retrieving the latest CapabilityStatement from the API endpoint.
Retrieving Current Extension Support
Before implementing extensions, retrieve the current CapabilityStatement to validate which extensions are supported:
# Production Environment
curl -X GET https://fhir.netsmartcloud.com/v4/metadata \
-H "Accept: application/fhir+json"
# Preview Environment
curl -X GET https://fhirtest.netsmartcloud.com/v4/metadata \
-H "Accept: application/fhir+json"
Supported Extensions by Resource
Basic
| Name | URI |
|---|---|
| Call Intake Caller | https://fhir.netsmartcloud.com/v4/StructureDefinition/callintake-caller |
| Call Intake Date | https://fhir.netsmartcloud.com/v4/StructureDefinition/callintake-date |
| Call Intake Disposition | https://fhir.netsmartcloud.com/v4/StructureDefinition/callintake-disposition |
| Call Intake Patient Name | https://fhir.netsmartcloud.com/v4/StructureDefinition/callintake-patient-name |
| Call Intake Program | https://fhir.netsmartcloud.com/v4/StructureDefinition/callintake-program |
| Call Intake Remarks | https://fhir.netsmartcloud.com/v4/StructureDefinition/callintake-remarks |
| Call Intake Type | https://fhir.netsmartcloud.com/v4/StructureDefinition/callintake-type |
Condition
Coverage
CoverageEligibilityRequest
| Name | URI |
|---|---|
| CoverageEligibilityRequest Benefit Plan | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityRequest-benefit-plan |
| CoverageEligibilityRequest Custom Status Code | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityRequest-custom-status-code |
| CoverageEligibilityRequest Encounter | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityRequest-encounterReference |
| CoverageEligibilityRequest Funding Source | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityRequest-funding-source |
| CoverageEligibilityRequest Program Code | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityRequest-programCode |
CoverageEligibilityResponse
| Name | URI |
|---|---|
| CoverageEligibilityResponse Benefit Plan | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityResponse-benefit-plan |
| CoverageEligibilityResponse Custom Status Code | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityResponse-custom-status-code |
| CoverageEligibilityResponse Encounter | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityResponse-encounterReference |
| CoverageEligibilityResponse Funding Source | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityResponse-funding-source |
| CoverageEligibilityResponse Program Code | https://fhir.netsmartcloud.com/v4/StructureDefinition/coverageEligibilityResponse-programCode |
Encounter
Observation
| Name | URI |
|---|---|
| Observation Smoking Status Name | https://fhir.netsmartcloud.com/v4/StructureDefinition/observation-smokingStatusName |
Patient
Procedure
| Name | URI |
|---|---|
| Procedure Pertaining to Event ID | https://fhir.netsmartcloud.com/v4/StructureDefinition/procedure-pertainingToEventID |
Extension Usage Guidelines
Implementation Notes
- Extensions are defined using StructureDefinition resources
- All Netsmart-specific extensions use the base URL:
https://fhir.netsmartcloud.com/v4/StructureDefinition/ - Standard HL7 and US Core extensions maintain their original URLs
- Extension support may vary by tenant configuration
Validation Requirements
Before implementing extensions in your application:
- Retrieve CapabilityStatement - Always get the current CapabilityStatement from
/metadata - Validate Extension Support - Check that required extensions are listed in the CapabilityStatement
- Test Implementation - Verify extension usage with actual API calls
- Monitor Changes - Extensions may be added or deprecated with API updates
Error Handling
For information about error responses when working with extensions, see Common Errors.
Common extension-related errors include:
- Invalid extension URLs
- Unsupported extensions for specific resources
- Malformed extension values
- Missing required extension elements
Related Resources
- CapabilityStatement - View supported extensions per resource
- Resources - Individual resource documentation with extension examples
- Common Errors - Error handling and troubleshooting
Support
For questions about extension support or implementation, contact Netsmart support through your designated support channels.