Scenario: Search the Endpoint Registry
Search FHIR R4 Endpoint resources with the parameters and modifiers advertised by DDFS.
Authorization
Use an OAuth 2.0 access token issued by OCI Identity Domains with the DDFS resource scopes required for Endpoint requests. Configure the client and obtain tokens by following Create an Integrated Application and DDFS Authentication Reference.
Search parameters
The R4 Endpoint search surface advertises connection-type, identifier, name, organization, payload-type, and status, in addition to _id, _lastUpdated, _profile, _tag, _count, and _total. See GET /api/fhir/r4/Endpoint for the exact definitions.
Search token parameters
Search with the advertised token parameters status, connection-type, payload-type, or identifier:
GET {base}/api/fhir/r4/Endpoint?status=active
GET {base}/api/fhir/r4/Endpoint?connection-type={system}|{code}
GET {base}/api/fhir/r4/Endpoint?payload-type={system}|{code}
GET {base}/api/fhir/r4/Endpoint?identifier={system}|{value}
Search by organization
Use a direct Organization reference or the advertised :identifier modifier. The organization parameter advertises no chains.
GET {base}/api/fhir/r4/Endpoint?organization=Organization/{organization_id}
GET {base}/api/fhir/r4/Endpoint?organization:identifier={system}|{value}
Search by name
Send one name value per request. The parameter advertises the :exact modifier and no other modifiers. It does not accept comma-delimited values.
GET {base}/api/fhir/r4/Endpoint?name={name}
GET {base}/api/fhir/r4/Endpoint?name:exact={exact_name}
Search by last update
The _lastUpdated parameter accepts the advertised date comparators. A range can use a maximum of two repeated parameters. Do not combine date values with a comma.
GET {base}/api/fhir/r4/Endpoint?_lastUpdated=ge2026-01-01T00:00:00Z&_lastUpdated=le2026-01-31T23:59:59Z
Use the advertised _count or _total result-control parameter as defined by the Endpoint search contract.