GetFamily

The GetFamily method works exactly like the Get method, but returns an array of eligibility records instead of a single record. 




Sample Code - Python

from oauth import OAuthConsumer
from oauth import OAuthClient
from oauth import OAuthToken
from oauth import OAuthRequest
from oauth import OAuthSignatureMethod_HMAC_SHA1
               
BASEPATH='http://secure.healthx.com'
APP_ID='123-123'
consumer=OAuthConsumer('key','secret')
token=OAuthToken('key','secret')

get_elig_url='%(basepath)s/api/eligibilityv1/json/getfamily/' % {'basepath':BASEPATH}             eligRequest=OAuthRequest.from_consumer_and_token(consumer,token,None,None,"POST",get_elig_url)
eligRequest.sign_request(sigMethod, consumer, token)
eligAuthheader=eligRequest.to_header()         
#take realm out of the headers, some oauth implementations incorrectly include it in the signature string, resulting in signature mismatches
eligAuthheader['Authorization']=eligAuthheader['Authorization'].replace('realm="", ','')

eligResult = urlfetch.fetch(url=get_elig_url, method=urlfetch.POST, payload="", headers={"Authorization":eligAuthheader['Authorization'], 'serviceid': APP_ID, "content-type":"application/json", "charset":"utf-8"})

Return Sample

<TotalRecordCount>3</TotalRecordCount>
<Records>
    <EligibilityRecord>
        <Accumulators i:nil="true"/>
        <AddDateTime>2009-01-19T11:18:17.18</AddDateTime>
        <Addr2 i:nil="true"/>
        <.../>
        <Zip>55333     </Zip>
    </EligibilityRecord>
    <EligibilityRecord>
        <Accumulators i:nil="true"/>
        <AddDateTime>2008-05-22T12:48:31.16</AddDateTime>
        <Addr2 i:nil="true"/>
        <.../>
        <Zip>55444     </Zip>
    </EligibilityRecord>
</Records>


Notes

By default, when this method is called on behalf of a dependent, the results include all dependent coverage records and the member's eligibility record (though not the member's coverage records).  This behavior can be configured by Healthx by toggling the Include Subscriber Coverages setting.