Search staffs by conditions

Search staffs by conditions

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Scope

staffs-directory:read

Query Params
int32
1 to 2147483647
Defaults to 1

Desired page

int32
1 to 50
Defaults to 50

Limit the number of prompts per page

string
length between 0 and 9999

Name of staff

string
length between 0 and 512

Search term to filter staffs by name or email.

string
length between 0 and 9999

Manager of staff

string
length between 0 and 9999

Speciality of staff

string
length between 0 and 9999

Job title of staff

string
length between 0 and 9999

External id of staff

string
length between 0 and 9999

Industry of staff

string
length between 0 and 9999

Gender of staff

string
length between 0 and 9999

Status of staff

string
length between 0 and 9999

Language of staff

string
length between 0 and 9999

Visit type name of staff

string
length between 0 and 150

The id of the location. Accepts multiple ids as a comma-separated list, in which case staff
associated with any of the given ids are returned.

string
length between 0 and 150

The name of the location which staff in

string
length between 0 and 150

The type of the location which staff in

string
length between 0 and 20

The zip-code of the location which staff in

string
length between 0 and 100

The city of the location which staff in

string
length between 0 and 100

The country name of location which staff in

string
length between 0 and 100

The region name (country subdivision) of location which staff in

string
length between 0 and 150

The id of the service. Accepts multiple ids as a comma-separated list, in which case staff
associated with any of the given ids are returned.

string
length between 0 and 9999

The name of the service provided by staff

string
length between 0 and 9999

The type of the service provided by staff

double
-90 to 90
  • Latitude and longitude are used together with distance. The search parameters include latitude and longitude to retrieve a list of all staffs within a certain radius.
  • Legacy alternative to the near_by.* parameters; cannot be combined with them.
  • Currently, these three parameters can only be used when the Feature Flag is enabled.
double
-180 to 180
  • Latitude and longitude are used together with distance. The search parameters include latitude and longitude to retrieve a list of all staffs within a certain radius.
  • Legacy alternative to the near_by.* parameters; cannot be combined with them.
  • Currently, these three parameters can only be used when the Feature Flag is enabled.
double
≥ 0
  • Latitude and longitude are used together with distance. The search parameters include latitude and longitude to retrieve a list of all staffs within a certain radius.
  • Distance is measured in meters.
  • If no distance is provided, the default distance configured in Industries-settings will be used.
  • Legacy alternative to the near_by.* parameters; cannot be combined with them.
  • Currently, these three parameters can only be used when the Feature Flag is enabled.
string
length between 2 and 2
  • The ISO 3166-1 alpha-2 country code (e.g. 'US') of the near_by.city or near_by.zip_code to resolve to a coordinate.
  • Required when near_by.city or near_by.zip_code is provided; providing near_by.country on its own is not a valid filter.
  • Cannot be combined with near_by.latitude/near_by.longitude, or with the legacy latitude/longitude/distance parameters.
string
length between 0 and 100
  • The city to resolve (via Google Maps), together with near_by.country, to a coordinate to retrieve a list of all staffs within a certain radius.
  • Mutually exclusive with near_by.zip_code; provide exactly one of the two.
  • Requires near_by.country to also be provided.
string
length between 0 and 20
  • The zip/postal code to resolve (via Google Maps), together with near_by.country, to a coordinate to retrieve a list of all staffs within a certain radius.
  • Mutually exclusive with near_by.city; provide exactly one of the two.
  • Requires near_by.country to also be provided.
double
-90 to 90
  • Latitude of the coordinate to search near. Must be provided together with near_by.longitude.
  • Cannot be combined with near_by.country/near_by.city/near_by.zip_code, or with the legacy latitude/longitude/distance parameters.
double
-180 to 180
  • Longitude of the coordinate to search near. Must be provided together with near_by.latitude.
  • Cannot be combined with near_by.country/near_by.city/near_by.zip_code, or with the legacy latitude/longitude/distance parameters.
double
≥ 0
  • Distance is measured in meters.
  • Requires either a near_by.country + near_by.city/near_by.zip_code group, or a near_by.latitude/near_by.longitude pair, to also be present.
  • If no distance is provided, the default distance configured in Industries-settings will be used.
  • Cannot be combined with the legacy latitude/longitude/distance parameters.
string
length between 0 and 9999
Defaults to name

Order by field, should be one of -> name, external_id, manager, speciality, job_title, date_of_hire, created_at, updated_at

string
length between 0 and 9999
Defaults to DESC

Sort field, should be one of -> DESC, ASC

string
length between 1 and 1000

Filters staffs by the values of their custom fields, using a structured query expression
in the format custom_field=<field_name> eq '<value>', combined with and/or and parentheses.
Only the eq operator is currently supported.

  • A single comparison.
    ?custom_field=visit_category eq 'wellness'
    returns the staffs whose visit_category is wellness.
  • or matches any of the given comparisons.
    ?custom_field=visit_category eq 'wellness' or visit_category eq 'acute_sick'
    returns the staffs whose visit_category is either wellness or acute_sick.
  • and requires all of the given comparisons to match.
    ?custom_field=visit_category eq 'wellness' and has_parking eq 'true'
    returns only the staffs that are in the wellness category and have parking.
  • Parentheses group comparisons and override the default precedence (and binds tighter than or).
    ?custom_field=visit_category eq 'wellness' and (has_parking eq 'true' or has_parking eq 'false')
  • The parameter can be repeated (up to 50 times); repeated occurrences are combined with and.
    ?custom_field=visit_category eq 'wellness'&custom_field=has_parking eq 'true'
    is equivalent to ?custom_field=visit_category eq 'wellness' and has_parking eq 'true'.

Field names are matched case-insensitively. String values must be enclosed in single quotes;
a literal single quote within a value is escaped by doubling it ('').
Value matching is case-insensitive for regular text custom fields, but case-sensitive for
single-select and multi-select custom fields (the value must match one of the field's
defined options exactly). Omitting the parameter leaves the results unfiltered.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json