eHealthExchange Healthcare Directory Implementation Guide
1.8.1 - Release 1
| Active as of 2025-10-27 |
<OperationDefinition xmlns="http://hl7.org/fhir">
<id value="search-near"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationDefinition search-near</b></p><a name="search-near"> </a><a name="hcsearch-near"> </a><p>URL: [base]/Organization/$search-near</p><h3>Parameters</h3><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>address</td><td/><td>1..*</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#Address">Address</a></td><td/><td><div><p>Addresses around which to search.</p>
</div></td></tr><tr><td>IN</td><td>radius</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#Distance">Distance</a></td><td/><td><div><p>Threshold radius.</p>
</div></td></tr><tr><td>IN</td><td>type</td><td/><td>0..*</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#Coding">Coding</a></td><td/><td><div><p>Filter on Organization.type.</p>
</div></td></tr><tr><td>IN</td><td>endpoint:missing</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#boolean">boolean</a></td><td/><td><div><p>Filter on absence of Organization.endpoint.</p>
</div></td></tr><tr><td>OUT</td><td>return</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></td><td/><td><div><p>Bundle of organizations within the threshold of one or more addresses.</p>
</div></td></tr></table></div>
</text>
<url
value="https://sequoiaproject.org/fhir/ehx/OperationDefinition/search-near"/>
<version value="1.8.1"/>
<name value="SearchNear"/>
<title value="Search Near"/>
<status value="active"/>
<kind value="operation"/>
<date value="2025-10-27T13:14:09-04:00"/>
<publisher value="eHealthExchange"/>
<contact>
<name value="eHealthExchange"/>
<telecom>
<system value="url"/>
<value value="https://ehealthexchange.org/"/>
</telecom>
</contact>
<description
value="Returns organizations containing locations that are within a specified radius of one or more specified addresses. See the following example, which searches for participants with endpoints that are within ten miles of the White House:
```json
{
"resourceType": "Parameters",
"parameter": [
{
"name": "address",
"valueAddress": {
"line": [
"1600 Pennsylvania Avenue NW"
],
"city": "Washington",
"state": "DC",
"postalCode": "20500"
}
},
{
"name": "radius",
"valueDistance": {
"value": 10,
"system": "http://unitsofmeasure.org",
"code": "[mi_i]"
}
},
{
"name": "type",
"valueCoding": {
"system": "https://sequoiaproject.org/fhir/sphd/CodeSystem/OrganizationType",
"code": "Participant"
}
},
{
"name": "endpoint:missing",
"valueBoolean": false
}
]
}
```"/>
<code value="search-near"/>
<base
value="https://sequoiaproject.org/fhir/ehx/OperationDefinition/search-near"/>
<resource value="Organization"/>
<system value="false"/>
<type value="true"/>
<instance value="false"/>
<parameter>
<name value="address"/>
<use value="in"/>
<min value="1"/>
<max value="*"/>
<documentation value="Addresses around which to search."/>
<type value="Address"/>
</parameter>
<parameter>
<name value="radius"/>
<use value="in"/>
<min value="1"/>
<max value="1"/>
<documentation value="Threshold radius."/>
<type value="Distance"/>
</parameter>
<parameter>
<name value="type"/>
<use value="in"/>
<min value="0"/>
<max value="*"/>
<documentation value="Filter on Organization.type."/>
<type value="Coding"/>
</parameter>
<parameter>
<name value="endpoint:missing"/>
<use value="in"/>
<min value="0"/>
<max value="1"/>
<documentation value="Filter on absence of Organization.endpoint."/>
<type value="boolean"/>
</parameter>
<parameter>
<name value="return"/>
<use value="out"/>
<min value="1"/>
<max value="1"/>
<documentation
value="Bundle of organizations within the threshold of one or more addresses."/>
<type value="Bundle"/>
</parameter>
</OperationDefinition>