core.medplumclient.searchone

MedplumClient.searchOne() method

Sends a FHIR search request for a single resource.

This is a convenience method for search() that returns the first resource rather than a Bundle.

Signature:

searchOne<K extends ResourceType>(resourceType: K, query?: QueryTypes, options?: RequestInit): ReadablePromise<ExtractResource<K> | undefined>;

Parameter	Type	Description
resourceType	K	The FHIR resource type.
query	QueryTypes	(Optional) Optional FHIR search query or structured query object. Can be any valid input to the URLSearchParams() constructor.
options	RequestInit	(Optional) Optional fetch options.

Returns:

ReadablePromise<ExtractResource<K> | undefined>

Promise to the first search result.

Example using a FHIR search string:

const patient = await client.searchOne('Patient', 'identifier=123');
console.log(patient);

The return value is the resource, if available; otherwise, undefined.