This
page
is
part
of
the
FHIR
Specification
(v4.0.1:
R4
(v5.0.0:
R5
-
Mixed
Normative
and
STU
)
).
This
is
the
current
published
version
in
it's
permanent
home
(it
will
always
be
available
at
this
URL).
The
current
version
which
supercedes
this
version
is
5.0.0
.
For
a
full
list
of
available
versions,
see
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
Patient
Administration
Work
Group
|
Maturity Level : 2 | Trial Use | Security Category : Business |
Compartments
:
|
The
technical
details
of
an
endpoint
that
can
be
used
for
electronic
services,
such
as
for
web
services
providing
XDS.b
or
XDS.b,
a
REST
endpoint
for
another
FHIR
server.
server,
or
a
s/Mime
email
address.
This
may
include
any
security
context
information.
An
endpoint
describes
the
technical
details
of
a
location
that
can
be
connected
to
for
the
delivery/retrieval
of
information.
Sufficient
information
is
required
to
ensure
that
a
connection
can
be
made
securely,
and
appropriate
data
transmitted
as
defined
by
the
endpoint
owner.
This
is
not
a
description
of
details
of
the
current
system,
as
found
in
CapabilityStatement
,
but
of
another
(potentially
external)
system.
These
may
be
locally
hosted
services,
regional
services,
or
national
service.
These resources are typically used to identify where to locate endpoint details for:
The
endpoint
is
distinct
from
a
capability
statement
in
that
the
CapabilityStatement
statement
describes
the
entire
capability
of
a
server
system
(and
in
the
metadata
case,
just
this
server)
system)
Where
the
endpoint
resource
describes
the
technical
details
for
how
to
connect,
and
for
what
purposes
(which
could
be
a
small
sub-set
of
the
server's
system's
capabilities,
and
might
not
be
a
FHIR
endpoint).
Endpoints are used to facilitate system to system communication, providing the details of the addressing of the system, purpose of use, protocols required/provided, and any other details required to communicate between the systems. (such as configuration parameters, require headers ...) The address value in the endpoint can only be used in the context of the provided details.
E.g. If the endpoint has a URL for an XDS service, using that in a browser by a user is meaningless.
E.g.2 If the endpoint has a US Direct address, using this to send a normal email message will not work, as they are not true email addresses (even though they appear to be)
A ContactPoint contains contact information, such as a phone number, web address that a user can directly interact with, no additional information would be required to use the value. The value is generally used to communicate with an entity directly, not a system.
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
TU | DomainResource |
The
technical
details
of
an
endpoint
that
can
be
used
for
electronic
services
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..* | Identifier |
Identifies
this
endpoint
across
multiple
systems
|
|
?! Σ | 1..1 | code |
active
|
suspended
|
error
|
off
|
entered-in-error
|
test
|
|
Σ |
|
|
Protocol/Profile/Standard
to
be
used
with
this
endpoint
connection
Binding: Endpoint Connection Type ( |
|
Σ | 0..1 | string |
A
name
that
this
endpoint
can
be
identified
by
|
| Σ | 0..1 | string |
Additional
details
about
the
endpoint
that
could
be
displayed
as
further
information
to
identify
the
description
beyond
its
name
|
![]() ![]() | Σ | 0..* | CodeableConcept |
The
type
of
environment(s)
exposed
at
this
endpoint
Binding: Endpoint Environment ( Extensible ) |
|
Σ | 0..1 | Reference ( Organization ) |
Organization
that
manages
this
endpoint
(might
not
be
the
organization
that
exposes
the
endpoint)
|
|
0..* | ContactPoint |
Contact
details
for
source
(e.g.
troubleshooting)
|
|
|
Σ | 0..1 | Period |
Interval
the
endpoint
is
expected
to
be
operational
|
|
0..* | BackboneElement |
Set
of
payloads
that
are
provided
by
this
endpoint
| |
![]() ![]() ![]() | Σ | 0..* | CodeableConcept |
The
type
of
content
that
may
be
used
at
this
endpoint
(e.g.
XDS
Discharge
summaries)
Binding: Endpoint Payload Type ( Example ) |
|
Σ | 0..* | code |
Mimetype
to
send.
If
not
specified,
the
content
could
be
anything
(including
no
payload,
if
the
connectionType
defined
this)
Binding: |
|
Σ | 1..1 | url |
The
technical
base
address
for
connecting
to
this
endpoint
|
|
0..* | string |
Usage
depends
on
the
channel
type
|
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
UML Diagram ( Legend )
XML Template
<<Endpoint xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Identifies this endpoint across multiple systems --></identifier>
< <</connectionType><status value="[code]"/><!-- 1..1 active | suspended | error | off | entered-in-error | test --> <connectionType><!-- 1..* CodeableConcept Protocol/Profile/Standard to be used with this endpoint connection --></connectionType> <name value="[string]"/><!-- 0..1 A name that this endpoint can be identified by --> <description value="[string]"/><!-- 0..1 Additional details about the endpoint that could be displayed as further information to identify the description beyond its name --> <environmentType><!-- 0..* CodeableConcept The type of environment(s) exposed at this endpoint --></environmentType> <managingOrganization><!-- 0..1 Reference(Organization) Organization that manages this endpoint (might not be the organization that exposes the endpoint) --></managingOrganization><</contact><contact><!-- 0..* ContactPoint Contact details for source (e.g. troubleshooting) --></contact> <period><!-- 0..1 Period Interval the endpoint is expected to be operational --></period><</payloadType> <<payload> <!-- 0..* Set of payloads that are provided by this endpoint --> <type><!-- 0..* CodeableConcept The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) --></type> <mimeType value="[code]"/><!-- 0..* Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this) --> </payload> <address value="[url]"/><!-- 1..1 The technical base address for connecting to this endpoint --> <header value="[string]"/><!-- 0..* Usage depends on the channel type --> </Endpoint>
JSON Template
{
"resourceType" : "",
"resourceType" : "Endpoint",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Identifies this endpoint across multiple systems
"
"
"status" : "<code>", // R! active | suspended | error | off | entered-in-error | test
"connectionType" : [{ CodeableConcept }], // R! Protocol/Profile/Standard to be used with this endpoint connection
"name" : "<string>", // A name that this endpoint can be identified by
"description" : "<string>", // Additional details about the endpoint that could be displayed as further information to identify the description beyond its name
"environmentType" : [{ CodeableConcept }], // The type of environment(s) exposed at this endpoint
"managingOrganization" : { Reference(Organization) }, // Organization that manages this endpoint (might not be the organization that exposes the endpoint)
"
"contact" : [{ ContactPoint }], // Contact details for source (e.g. troubleshooting)
"period" : { Period }, // Interval the endpoint is expected to be operational
"
"
"payload" : [{ // Set of payloads that are provided by this endpoint
"type" : [{ CodeableConcept }], // The type of content that may be used at this endpoint (e.g. XDS Discharge summaries)
"mimeType" : ["<code>"] // Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this)
}],
"address" : "<url>", // R! The technical base address for connecting to this endpoint
"header" : ["<string>"] // Usage depends on the channel type
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .![]()
[ a fhir:;[ a fhir:Endpoint; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtensionfhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir:fhir:identifier ( [ Identifier ] ... ) ; # 0..* Identifies this endpoint across multiple systems fhir:status [ code ] ; # 1..1 active | suspended | error | off | entered-in-error | test fhir:connectionType ( [ CodeableConcept ] ... ) ; # 1..* Protocol/Profile/Standard to be used with this endpoint connection fhir:name [ string ] ; # 0..1 A name that this endpoint can be identified by fhir:description [ string ] ; # 0..1 Additional details about the endpoint that could be displayed as further information to identify the description beyond its name fhir:environmentType ( [ CodeableConcept ] ... ) ; # 0..* The type of environment(s) exposed at this endpoint fhir:managingOrganization [ Reference(Organization) ] ; # 0..1 Organization that manages this endpoint (might not be the organization that exposes the endpoint) fhir:contact ( [ ContactPoint ] ... ) ; # 0..* Contact details for source (e.g. troubleshooting) fhir:period [ Period ] ; # 0..1 Interval the endpoint is expected to be operational fhir:payload ( [ # 0..* Set of payloads that are provided by this endpoint fhir:type ( [ CodeableConcept ] ... ) ; # 0..* The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) fhir:mimeType ( [ code ] ... ) ; # 0..* Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this) ] ... ) ; fhir:address [ url ] ; # 1..1 The technical base address for connecting to this endpoint fhir:header ( [ string ] ... ) ; # 0..* Usage depends on the channel type ]
Changes
since
R3
from
both
R4
and
R4B
| Endpoint | |
| Endpoint.status |
|
| Endpoint.connectionType |
|
|
|
|
| Endpoint.environmentType |
|
| Endpoint.payload |
|
| Endpoint.payload.type |
|
|
|
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .
See
R3
<-->
R4
<-->
R5
Conversion
Maps
(status
=
3
tests
that
all
execute
ok.
All
tests
pass
round-trip
testing
and
all
r3
resources
are
valid.)
See
Conversions
Summary
.)
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
TU | DomainResource |
The
technical
details
of
an
endpoint
that
can
be
used
for
electronic
services
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..* | Identifier |
Identifies
this
endpoint
across
multiple
systems
|
|
?! Σ | 1..1 | code |
active
|
suspended
|
error
|
off
|
entered-in-error
|
test
|
|
Σ |
|
|
Protocol/Profile/Standard
to
be
used
with
this
endpoint
connection
Binding: Endpoint Connection Type ( |
|
Σ | 0..1 | string |
A
name
that
this
endpoint
can
be
identified
by
|
| Σ | 0..1 | string |
Additional
details
about
the
endpoint
that
could
be
displayed
as
further
information
to
identify
the
description
beyond
its
name
|
![]() ![]() | Σ | 0..* | CodeableConcept |
The
type
of
environment(s)
exposed
at
this
endpoint
Binding: Endpoint Environment ( Extensible ) |
|
Σ | 0..1 | Reference ( Organization ) |
Organization
that
manages
this
endpoint
(might
not
be
the
organization
that
exposes
the
endpoint)
|
|
0..* | ContactPoint |
Contact
details
for
source
(e.g.
troubleshooting)
|
|
|
Σ | 0..1 | Period |
Interval
the
endpoint
is
expected
to
be
operational
|
|
0..* | BackboneElement |
Set
of
payloads
that
are
provided
by
this
endpoint
| |
![]() ![]() ![]() | Σ | 0..* | CodeableConcept |
The
type
of
content
that
may
be
used
at
this
endpoint
(e.g.
XDS
Discharge
summaries)
Binding: Endpoint Payload Type ( Example ) |
|
Σ | 0..* | code |
Mimetype
to
send.
If
not
specified,
the
content
could
be
anything
(including
no
payload,
if
the
connectionType
defined
this)
Binding: |
|
Σ | 1..1 | url |
The
technical
base
address
for
connecting
to
this
endpoint
|
|
0..* | string |
Usage
depends
on
the
channel
type
|
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
XML Template
<<Endpoint xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Identifies this endpoint across multiple systems --></identifier>
< <</connectionType><status value="[code]"/><!-- 1..1 active | suspended | error | off | entered-in-error | test --> <connectionType><!-- 1..* CodeableConcept Protocol/Profile/Standard to be used with this endpoint connection --></connectionType> <name value="[string]"/><!-- 0..1 A name that this endpoint can be identified by --> <description value="[string]"/><!-- 0..1 Additional details about the endpoint that could be displayed as further information to identify the description beyond its name --> <environmentType><!-- 0..* CodeableConcept The type of environment(s) exposed at this endpoint --></environmentType> <managingOrganization><!-- 0..1 Reference(Organization) Organization that manages this endpoint (might not be the organization that exposes the endpoint) --></managingOrganization><</contact><contact><!-- 0..* ContactPoint Contact details for source (e.g. troubleshooting) --></contact> <period><!-- 0..1 Period Interval the endpoint is expected to be operational --></period><</payloadType> <<payload> <!-- 0..* Set of payloads that are provided by this endpoint --> <type><!-- 0..* CodeableConcept The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) --></type> <mimeType value="[code]"/><!-- 0..* Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this) --> </payload> <address value="[url]"/><!-- 1..1 The technical base address for connecting to this endpoint --> <header value="[string]"/><!-- 0..* Usage depends on the channel type --> </Endpoint>
JSON Template
{
"resourceType" : "",
"resourceType" : "Endpoint",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Identifies this endpoint across multiple systems
"
"
"status" : "<code>", // R! active | suspended | error | off | entered-in-error | test
"connectionType" : [{ CodeableConcept }], // R! Protocol/Profile/Standard to be used with this endpoint connection
"name" : "<string>", // A name that this endpoint can be identified by
"description" : "<string>", // Additional details about the endpoint that could be displayed as further information to identify the description beyond its name
"environmentType" : [{ CodeableConcept }], // The type of environment(s) exposed at this endpoint
"managingOrganization" : { Reference(Organization) }, // Organization that manages this endpoint (might not be the organization that exposes the endpoint)
"
"contact" : [{ ContactPoint }], // Contact details for source (e.g. troubleshooting)
"period" : { Period }, // Interval the endpoint is expected to be operational
"
"
"payload" : [{ // Set of payloads that are provided by this endpoint
"type" : [{ CodeableConcept }], // The type of content that may be used at this endpoint (e.g. XDS Discharge summaries)
"mimeType" : ["<code>"] // Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this)
}],
"address" : "<url>", // R! The technical base address for connecting to this endpoint
"header" : ["<string>"] // Usage depends on the channel type
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .![]()
[ a fhir:;[ a fhir:Endpoint; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtensionfhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir: fhir:fhir:identifier ( [ Identifier ] ... ) ; # 0..* Identifies this endpoint across multiple systems fhir:status [ code ] ; # 1..1 active | suspended | error | off | entered-in-error | test fhir:connectionType ( [ CodeableConcept ] ... ) ; # 1..* Protocol/Profile/Standard to be used with this endpoint connection fhir:name [ string ] ; # 0..1 A name that this endpoint can be identified by fhir:description [ string ] ; # 0..1 Additional details about the endpoint that could be displayed as further information to identify the description beyond its name fhir:environmentType ( [ CodeableConcept ] ... ) ; # 0..* The type of environment(s) exposed at this endpoint fhir:managingOrganization [ Reference(Organization) ] ; # 0..1 Organization that manages this endpoint (might not be the organization that exposes the endpoint) fhir:contact ( [ ContactPoint ] ... ) ; # 0..* Contact details for source (e.g. troubleshooting) fhir:period [ Period ] ; # 0..1 Interval the endpoint is expected to be operational fhir:payload ( [ # 0..* Set of payloads that are provided by this endpoint fhir:type ( [ CodeableConcept ] ... ) ; # 0..* The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) fhir:mimeType ( [ code ] ... ) ; # 0..* Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this) ] ... ) ; fhir:address [ url ] ; # 1..1 The technical base address for connecting to this endpoint fhir:header ( [ string ] ... ) ; # 0..* Usage depends on the channel type ]
Changes
since
Release
3
from
both
R4
and
R4B
| Endpoint | |
| Endpoint.status |
|
| Endpoint.connectionType |
|
|
|
|
| Endpoint.environmentType |
|
| Endpoint.payload |
|
| Endpoint.payload.type |
|
|
|
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .
See
R3
<-->
R4
<-->
R5
Conversion
Maps
(status
=
3
tests
that
all
execute
ok.
All
tests
pass
round-trip
testing
and
all
r3
resources
are
valid.)
See
Conversions
Summary
.)
See
the
Profiles
&
Extensions
and
the
alternate
Additional
definitions:
Master
Definition
XML
+
JSON
,
XML
Schema
/
Schematron
+
JSON
Schema
,
ShEx
(for
Turtle
)
+
see
the
extensions
,
the
spreadsheet
version
&
the
dependency
analysis
| Path |
|
Type |
|
|---|---|---|---|
| Endpoint.status | EndpointStatus | Required | The status of the endpoint. |
| Endpoint.connectionType | EndpointConnectionType |
|
This is an example value set defined by the FHIR project, that could be used to represent possible connection type profile values. |
| Endpoint.environmentType | EndpointEnvironment | Extensible |
The environment type of the endpoint. |
|
|
EndpointPayloadType | Example |
This is an example value set defined by the FHIR project, that could be used to represent possible payload document types. |
| Endpoint.payload.mimeType |
urn:ietf:bcp:13
)
|
Required |
This value set includes all possible codes from BCP-13 (see http://tools.ietf.org/html/bcp13) |

Search parameters for this resource. See also the full list of search parameters for this resource , and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
| connection-type | token | Protocol/Profile/Standard to be used with this endpoint connection | Endpoint.connectionType | |
| identifier | token | Identifies this endpoint across multiple systems | Endpoint.identifier | |
| name | string | A name that this endpoint can be identified by | Endpoint.name | |
| organization | reference | The organization that is managing the endpoint |
Endpoint.managingOrganization
( Organization ) |
|
| payload-type | token | The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) |
|
|
| status | token | The current status of the Endpoint (usually expected to be active) | Endpoint.status |