individualsByName

The individualsByName query is used to search for HCPs by ...

name (free text criteria) as a search term for the query

... and ...

place (country) to narrow down the query

Schema

 

 

type Query {

individualsByName(

    first: Int = 10,

    offset: Int = 0,

    userId: String,

    criteria: String!,

    locale: String,

    country: String

  ): IndividualResult

}

 

 

Field

Type

Description

first

Int

Optional for pagination. Specifies ...

10 (default)

... to limit the number of results to get for the first page. The same number to limit results can be specified again to limit results for each of the following pages.

If this limit exceeds the server's number, then number of results is determined by the server.

offset

Int

Optional for pagination. Specifies ...

0 (default)

... to not offset the first number of results for the first page. However, offset is required for a following page to skip <total number results already retrieved on previous pages> to the next number to get from remaining results. For example:

  "offset: Int = 0" and "first: Int = 10" gets first 10 results for page 1

  "offset: Int = 10" and "first: Int = 10" skips first 10 results to get next 10 results for page 2

  "offset: Int = 20" and "first: Int = 10" skips first 20 results to get next 10 results for page 3

userID

String

Optional. ID of app.

criteria

String

Specifies a free text name (partial or full name) to find one or more HCPs. For example:

criteria: "John doe"

locale

String

Optional. Specifies the language of users in a country/region. For example:

locale: "en"  (default)

If not specified, then the default locale of the space is used.

country

String

Optional. Limit the search to HCP names within a country.

 

 

 

Response

IndividualResult

A JSON response with an object of the IndividualResult type as the result.

Fault

ActivityException

If a server error occurs or an incorrect input is specified.

Discussion

Criteria in this query is from a "search request" made by your app for a search on HCPs, such as a search inputted (with the help of autocomplete suggestions) on the prebuilt  Search block. To get data without implementing a UI, HealthCare Locator provides the following calls:

         getIndividualByName (SDK for Android)

         fetchIndividualsByNameWith (SDK for iOS)

Review the HCPs that come with your subscription.

This query is sent to the Autocomplete endpoint of the Activity API.

Availability

HealthCare Locator SDK 1.0 (and versions earlier than 1.2.15)

GraphQL Activity API 1.0