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}

NameDescriptionTypeAdditional 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

NameDescriptionTypeAdditional 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.

Response Formats

application/json, text/json

Sample:
{
  "id": "cf3d086e-2032-432b-a052-d5a4685fbaab",
  "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": "2024-04-26T08:25:20.2399914Z",
  "updateDate": "2024-04-26T08:25:20.2399914Z",
  "source": "sample string 14",
  "programId": "5a40f446-3854-4643-bafa-05af7d331df3",
  "programName": "sample string 16",
  "programTitle": "sample string 17",
  "referringMemberId": "a9a1f550-42ad-4370-899b-82be87d1c1c5",
  "referringMemberName": "sample string 19",
  "memberEmail": "sample string 20",
  "memberReferralCode": "sample string 21",
  "memberExternalIdentifier": "sample string 22",
  "approvedDate": "2024-04-26T08:25:20.2399914Z",
  "qualifiedDate": "2024-04-26T08:25:20.2399914Z",
  "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"
}

application/xml, text/xml

Sample:
<referral xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <id>cf3d086e-2032-432b-a052-d5a4685fbaab</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>2024-04-26T08:25:20.2399914+00:00</createDate>
  <preferredContact>sample string 11</preferredContact>
  <updateDate>2024-04-26T08:25:20.2399914+00:00</updateDate>
  <source>sample string 14</source>
  <programId>5a40f446-3854-4643-bafa-05af7d331df3</programId>
  <programName>sample string 16</programName>
  <programTitle>sample string 17</programTitle>
  <referringMemberId>a9a1f550-42ad-4370-899b-82be87d1c1c5</referringMemberId>
  <referringMemberName>sample string 19</referringMemberName>
  <memberEmail>sample string 20</memberEmail>
  <memberReferralCode>sample string 21</memberReferralCode>
  <memberExternalIdentifier>sample string 22</memberExternalIdentifier>
  <approvedDate>2024-04-26T08:25:20.2399914+00:00</approvedDate>
  <qualifiedDate>2024-04-26T08:25:20.2399914+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>
</referral>