Table of Contents

Use

The Inactivate API is used to get practitioners previously returned to a Client through the Search API that have been inactivated since a give date / time value.

Method

  • Method: GET

URL

  • URL Structure: Root/Version/Request&Security

Within that structure, this section documents how the Request portion is used for inactivate requests. The following points are relevant to structuring inactivate requests:

  • Results are paginated
  • The default is 10 returns per page
  • The maximum page size is 250 returns per page
  • Index names are used to define search universes. Currently, use masterfile for all queries.
  • A given client can only reference a single index
  • Returns contain identifiers only
  • The request requires a date / time value. Returns will be of records inactivated since the specified date / time value.
  • The Client should keep track of the current date / time each time this service is invoked, using that value as the input date / time the next time the service is called.

Request

The Request portion of an inactivate request consists of the command, two required parameters, and two optional parameters: Command/Index?Time&Page Size&Page Number

  • Command = inactivate

Required:

  • Index - Names the index used for inactivations. Currently, use masterfile for all queries.
  • Time - An ISO formatted date string indicating the date / time after which inactivations will result in a return (e.g., time=2000-05-29T16:24:08.412Z).

Optional:

Page Size - Defines the number of returns per page. Default = 10. Max. = 250.

  • Format: pageSize=n
  • Example: pageSize=20

Page Number - Defines the page to return. If not specified, returns the first page of results.

  • Format: page=n
  • Example: page=3 - Returns the 3rd page of results.

Any parameters after the first must be separated by an ampersand (&). An ampersand (&) must precede the Security portion of the URL.

Inactivate API URL Example

The following URL would return the first page of records inactivated since the date / time given, with a page size of 20 records per page:

https://api.hmsonline.com/v1/inactivate/masterfile?time=2000-05-29T16:24:08.412Z&pageSize=20&page=1&timestamp=1369844777731&key=EU2BD6eHBQeUMpMxDW9dmg==&signature=8qrFmQbQgILzdDeQfbJTxHXeZvE=

Note: All security values shown here and throughout this documentation are for illustration purposes only and will not work as shown. See Security Credentials for more information.

Body

  • None for this API