This article will cover the following:
- How to Use the Lead Status Master Report
- How Buyers Update Lead Statuses via API
- Sample API Request
- API Response Codes
How to Use the Lead Status Master Report
The Lead Status Master Report consolidates all Buyer status updates in one view, displaying each Status as a column so you can measure lead quality across your distribution network in real time.
To access the report:
- Click the Reports main tab.
- Click Master Reports.
- Click the Lead Status sub-tab.
Each Status you created (e.g. Funded, Unqualified, In Progress) appears as its own column. Custom Fields also appear as columns. Use the date filters and dimension selectors to segment by Buyer, Offer, Vertical, or date range.
How Buyers Update Lead Statuses via API
Buyers update lead statuses by making GET requests to the CAKE Lead Update API using their Buyer API Key. Each request targets a specific lead by its CAKE Lead ID and sets or updates its status.
The Buyer API Key is found on the Buyer Card in CAKE under the Home tab. Share this key with your Buyers for integration.
The API endpoint follows this format:
https://YourDomain.com/api/1/buyers.asmx/UpdateLeadStatus
Required parameters:
api_key— The Buyer's unique API key.lead_id— The CAKE Lead ID returned at the time of lead purchase.status— The status name to assign (must match a configured Status exactly).sub_status— (Optional) The sub-status name to assign.- Custom field parameters — Any additional custom fields configured in Lead Statuses, passed by their field name.
Sample API Request
The following example updates lead C8097F17 to a status of "Funded" with a sub-status of "Full Payment" and a custom field value of $25,000:
https://YourDomain.com/api/1/buyers.asmx/UpdateLeadStatus?api_key=BuyerAPIKeyHere&lead_id=C8097F17&status=Funded&sub_status=Full+Payment&loan_amount=25000
Where loan_amount is a custom field configured in the Lead Statuses setup.
API Response Codes
The API returns an XML response indicating success or failure:
<result>
<code>0</code>
<msg>success</msg>
</result>
| Code | Meaning |
|---|---|
0 | Success — lead status updated |
1 | Invalid API key |
2 | Lead ID not found |
3 | Status not recognized — check spelling matches configured Status exactly |
4 | Lead Statuses not enabled in this CAKE instance |
You may also be interested in:
If you have any questions, please reach out to your dedicated CAKE Client Success Manager/Account Manager or contact the CAKE Support Team at support@getCAKE.com.