API v1

Look up member by identifier

Changed on

Look up a member by one of the supported identifier combinations:

  • subscriber_id only: exact match on subscriber ID
  • phone_number only: matches primary or alternate phone (digit-normalized)
  • subscriber_id + date_of_birth: both must match the same record

Returns basic member information including support team and language.

Requires scope: members:read

Note: Uses POST to keep PHI out of URLs (compliance requirement).

post/api/v1/members/lookup

Request

  • Base URL
    https://api.cloverhealth.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.cloverhealth.com/api/v1/members/lookup
  • Auth
    API key in header X-MC2-Signature

Request body

subscriber_idstring nullable
phone_numberstring nullable
date_of_birthstring date nullable
call_sidstring nullable

Response

OK

lookup_statusstring nullable
subscriber_idstring nullable
first_namestring nullable
last_namestring nullable
master_record_idstring nullable
support_teamstring nullable
language_codestring nullable
engagement_idstring nullable
preferred_worker_sidstring

Changes

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status