POST api/referrals/status

Updates the status of a referral. ("Going to be deprecated" please use POST api/referral/update).

Request Information

URI Parameters

Query String:

None.

Body Parameters

A list of required structures containing the referral information and new status.

Name	Description	Type	Additional information
referralId	ID of the referral.	string	Required
programId	ID of the program that the referral belongs to. Optional.	string	None.
status	The value can be "pending", "qualified", "approved", "denied".	string	Required
amount	Amount. Optional.	decimal number	None.
publicNote	Public Note. Optional.	string	None.

Request Formats

application/json, text/json

Sample:

{
  "referralId": "sample string 1",
  "programId": "sample string 2",
  "status": "sample string 3",
  "amount": 1.0,
  "publicNote": "sample string 4"
}

application/xml, text/xml

Sample:

<referralStatus xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <amount>1</amount>
  <programId>sample string 2</programId>
  <publicNote>sample string 4</publicNote>
  <referralId>sample string 1</referralId>
  <status>sample string 3</status>
</referralStatus>

Response Information

Resource Description

[HTTP Status 200 - OK]

Type: ReferralConfirmation

Name	Description	Type	Additional information
referral	Structure containing details about the referral.	Referral	None.
message	The message provides more information about the results of the client's request. Review this field for error information.	string	None.

Response Formats

application/json, text/json

Sample:

{
  "message": "sample string 1",
  "referral": {
    "id": "e6824155-6fba-4964-a5ce-320bbb63db34",
    "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:31:48.2900859Z",
    "updateDate": "2025-10-19T14:31:48.2900859Z",
    "source": "sample string 14",
    "programId": "92c60bbb-5628-48df-88c9-3007cafecceb",
    "programName": "sample string 16",
    "programTitle": "sample string 17",
    "referringMemberId": "08932bf1-7412-453d-9d36-0c7e449a401b",
    "referringMemberName": "sample string 19",
    "memberEmail": "sample string 20",
    "memberReferralCode": "sample string 21",
    "memberExternalIdentifier": "sample string 22",
    "approvedDate": "2025-10-19T14:31:48.2900859Z",
    "qualifiedDate": "2025-10-19T14:31:48.2900859Z",
    "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": "3c8813da-2e08-4409-b45d-3e15e6140ac6",
    "recruiterSourceName": "sample string 50",
    "recruiterSourceEmail": "sample string 51",
    "recruiterAssignedId": "b4761dea-5f8b-4e57-8590-f424d67ec41c",
    "recruiterAssignedName": "sample string 52",
    "recruiterAssignedEmail": "sample string 53"
  }
}

application/xml, text/xml

Sample:

<referralConfirmation xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <message>sample string 1</message>
  <referral>
    <id>e6824155-6fba-4964-a5ce-320bbb63db34</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:31:48.2900859+00:00</createDate>
    <preferredContact>sample string 11</preferredContact>
    <updateDate>2025-10-19T14:31:48.2900859+00:00</updateDate>
    <source>sample string 14</source>
    <programId>92c60bbb-5628-48df-88c9-3007cafecceb</programId>
    <programName>sample string 16</programName>
    <programTitle>sample string 17</programTitle>
    <referringMemberId>08932bf1-7412-453d-9d36-0c7e449a401b</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:31:48.2900859+00:00</approvedDate>
    <qualifiedDate>2025-10-19T14:31:48.2900859+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>3c8813da-2e08-4409-b45d-3e15e6140ac6</recruiterSourceId>
    <recruiterSourceName>sample string 50</recruiterSourceName>
    <recruiterSourceEmail>sample string 51</recruiterSourceEmail>
    <recruiterAssignedId>b4761dea-5f8b-4e57-8590-f424d67ec41c</recruiterAssignedId>
    <recruiterAssignedName>sample string 52</recruiterAssignedName>
    <recruiterAssignedEmail>sample string 53</recruiterAssignedEmail>
  </referral>
</referralConfirmation>