GET api/referral/single

Get a single Referral. At least one of email, referralId or externalId is required.

Request Information

URI Parameters

Query String: email={email}&referralId={referralId}&externalId={externalId}

Name	Description	Type	Additional information
email	The email address of the referral	string	Default value is
referralId	The unique identifier of the referral	string	Default value is
externalId	The external identifier of the referral	string	Default value is

Body Parameters

None.

Response Information

Resource Description

[HTTP Status 200 - OK] A single Referral.

Type: Referral

Name	Description	Type	Additional information
id	The unique ID of the referral.	globally unique identifier	None.
displayName	Referral's Display Name	string	None.
firstName	Referral first name	string	None.
lastName	Referral last name	string	None.
fullName		string	None.
email	Referral email address	string	None.
externalIdentifier	An alternative ID provided to help link the member to relevant data in external systems.	string	None.
phoneNumber		string	None.
amount		decimal number	None.
amountFormatted		string	None.
preferredContact	The preferred means to contact the referral. The values an be 'email', 'callMorning', 'callAfternoon', or 'callEvening'.	string	None.
createDate		date	None.
updateDate		date	None.
source		string	None.
programId	The unique ID of the referral program that the referral responded to.	globally unique identifier	None.
programName		string	None.
programTitle		string	None.
referringMemberId	The unique ID of the member that made the referral.	globally unique identifier	None.
referringMemberName	The name of the member that made the referral.	string	None.
memberEmail		string	None.
memberReferralCode		string	None.
memberExternalIdentifier		string	None.
approvedDate		date	None.
qualifiedDate		date	None.
status	The value can be "pending", "qualified", "approved", "denied".	string	None.
companyName		string	None.
note		string	None.
publicNote		string	None.
customOption1Name		string	None.
customOption2Name		string	None.
customText1Name		string	None.
customText2Name		string	None.
customText3Name		string	None.
customOption1Value		string	None.
customOption2Value		string	None.
customText1Value		string	None.
customText2Value		string	None.
customText3Value		string	None.
conversionNote		string	None.
conversionIPAddress		string	None.
utmSource		string	None.
utmMedium		string	None.
utmCampaign		string	None.
browserReferrerUrl		string	None.
IPAddressSource		string	None.
addressLine1	Referral address line 1. Optional.	string	None.
addressLine2	Referral address line 2. Optional.	string	None.
city	Referral city name. Optional.	string	None.
region	Referral region, must be a region name or ISO_3166-2 subdivision code, can only be supplied if country is also provided. Optional.	string	None.
postalCode	Referral postal code. Optional.	string	None.
country	Referral country name or ISO_3166-2 country code. Optional.	string	None.
recruiterSourceId		globally unique identifier	None.
recruiterSourceName		string	None.
recruiterSourceEmail		string	None.
recruiterAssignedId		globally unique identifier	None.
recruiterAssignedName		string	None.
recruiterAssignedEmail		string	None.

Response Formats

application/json, text/json

Sample:

{
  "id": "ad86e354-aab0-4f94-8b91-4c62f9b93585",
  "displayName": "sample string 2",
  "firstName": "sample string 3",
  "lastName": "sample string 4",
  "fullName": "sample string 5",
  "email": "sample string 6",
  "externalIdentifier": "sample string 7",
  "phoneNumber": "sample string 8",
  "amount": 9.0,
  "amountFormatted": "sample string 10",
  "preferredContact": "sample string 11",
  "createDate": "2025-10-19T14:59:28.5358371Z",
  "updateDate": "2025-10-19T14:59:28.5358371Z",
  "source": "sample string 14",
  "programId": "05fd8a57-a1e1-4bc9-b669-db4261337188",
  "programName": "sample string 16",
  "programTitle": "sample string 17",
  "referringMemberId": "185800c9-a2b1-4b34-9314-a18d876dacc8",
  "referringMemberName": "sample string 19",
  "memberEmail": "sample string 20",
  "memberReferralCode": "sample string 21",
  "memberExternalIdentifier": "sample string 22",
  "approvedDate": "2025-10-19T14:59:28.5358371Z",
  "qualifiedDate": "2025-10-19T14:59:28.5358371Z",
  "status": "sample string 23",
  "companyName": "sample string 24",
  "note": "sample string 25",
  "publicNote": "sample string 26",
  "customOption1Name": "sample string 27",
  "customOption2Name": "sample string 28",
  "customText1Name": "sample string 29",
  "customText2Name": "sample string 30",
  "customText3Name": "sample string 31",
  "customOption1Value": "sample string 32",
  "customOption2Value": "sample string 33",
  "customText1Value": "sample string 34",
  "customText2Value": "sample string 35",
  "customText3Value": "sample string 36",
  "conversionNote": "sample string 37",
  "conversionIPAddress": "sample string 38",
  "utmSource": "sample string 39",
  "utmMedium": "sample string 40",
  "utmCampaign": "sample string 41",
  "browserReferrerUrl": "sample string 42",
  "IPAddressSource": "sample string 43",
  "addressLine1": "sample string 44",
  "addressLine2": "sample string 45",
  "city": "sample string 46",
  "region": "sample string 47",
  "postalCode": "sample string 48",
  "country": "sample string 49",
  "recruiterSourceId": "6becddf2-a5b7-4424-924d-5240d940bebc",
  "recruiterSourceName": "sample string 50",
  "recruiterSourceEmail": "sample string 51",
  "recruiterAssignedId": "1324f293-b2fa-4cb7-aed9-ec47c2e940e8",
  "recruiterAssignedName": "sample string 52",
  "recruiterAssignedEmail": "sample string 53"
}

application/xml, text/xml

Sample:

<referral xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <id>ad86e354-aab0-4f94-8b91-4c62f9b93585</id>
  <displayName>sample string 2</displayName>
  <firstName>sample string 3</firstName>
  <lastName>sample string 4</lastName>
  <fullName>sample string 5</fullName>
  <email>sample string 6</email>
  <externalIdentifier>sample string 7</externalIdentifier>
  <phoneNumber>sample string 8</phoneNumber>
  <amount>9</amount>
  <amountFormatted>sample string 10</amountFormatted>
  <createDate>2025-10-19T14:59:28.5358371+00:00</createDate>
  <preferredContact>sample string 11</preferredContact>
  <updateDate>2025-10-19T14:59:28.5358371+00:00</updateDate>
  <source>sample string 14</source>
  <programId>05fd8a57-a1e1-4bc9-b669-db4261337188</programId>
  <programName>sample string 16</programName>
  <programTitle>sample string 17</programTitle>
  <referringMemberId>185800c9-a2b1-4b34-9314-a18d876dacc8</referringMemberId>
  <referringMemberName>sample string 19</referringMemberName>
  <memberEmail>sample string 20</memberEmail>
  <memberReferralCode>sample string 21</memberReferralCode>
  <memberExternalIdentifier>sample string 22</memberExternalIdentifier>
  <approvedDate>2025-10-19T14:59:28.5358371+00:00</approvedDate>
  <qualifiedDate>2025-10-19T14:59:28.5358371+00:00</qualifiedDate>
  <status>sample string 23</status>
  <companyName>sample string 24</companyName>
  <note>sample string 25</note>
  <publicNote>sample string 26</publicNote>
  <customOption1Name>sample string 27</customOption1Name>
  <customOption2Name>sample string 28</customOption2Name>
  <customText1Name>sample string 29</customText1Name>
  <customText2Name>sample string 30</customText2Name>
  <customText3Name>sample string 31</customText3Name>
  <customOption1Value>sample string 32</customOption1Value>
  <customOption2Value>sample string 33</customOption2Value>
  <customText1Value>sample string 34</customText1Value>
  <customText2Value>sample string 35</customText2Value>
  <customText3Value>sample string 36</customText3Value>
  <conversionNote>sample string 37</conversionNote>
  <conversionIPAddress>sample string 38</conversionIPAddress>
  <utmSource>sample string 39</utmSource>
  <utmMedium>sample string 40</utmMedium>
  <utmCampaign>sample string 41</utmCampaign>
  <browserReferrerUrl>sample string 42</browserReferrerUrl>
  <IPAddressSource>sample string 43</IPAddressSource>
  <addressLine1>sample string 44</addressLine1>
  <addressLine2>sample string 45</addressLine2>
  <city>sample string 46</city>
  <region>sample string 47</region>
  <postalCode>sample string 48</postalCode>
  <country>sample string 49</country>
  <recruiterSourceId>6becddf2-a5b7-4424-924d-5240d940bebc</recruiterSourceId>
  <recruiterSourceName>sample string 50</recruiterSourceName>
  <recruiterSourceEmail>sample string 51</recruiterSourceEmail>
  <recruiterAssignedId>1324f293-b2fa-4cb7-aed9-ec47c2e940e8</recruiterAssignedId>
  <recruiterAssignedName>sample string 52</recruiterAssignedName>
  <recruiterAssignedEmail>sample string 53</recruiterAssignedEmail>
</referral>