Instructions
The absence of any "required" field will result in an error.
If you don't collect a required field, please contact your account manager for further instructionss.
Some fields are not required, but if you choose not to send them, this could reduce the lead's chance to be sold to a buyer/contractor.
Note: Not sending optional fields will not result in an error.
Do not begin posting leads to Same Day Pros until we've manually verified your test data and we've explicitly notified you that your account is ready to go live.
Any leads posted to Same Day Pros without confirmation from your account manager will not be counted as a billable lead and will be returned.
Note : We recommend HTTP/2.0 POST in the Request
PING & POST
PING Response
curl "https://api.samedaypros.com/ping.php" \
--request POST \
--header "Content-Type: application/x-www-form-urlencoded" \
--data "aff_id=1&source_id=123&sub_aff_id=xyz&zip=29568&maincat=Additions&subcat=Kitchen Addition&ip=49.42.2425.42&universal_lead_id=9252592ufjkoajf8fj83f&tcpa_consent=1&tcpa_language=By clicking 'submit', I consent that as part of the…&testMode=1"
Our system will respond in the format command below
Success Response: Fixed PricingSuccess|NTg3MwTrSuccess Response: Fixed Pricing (response_type must be in "json" format){"status":"Success","ping_response_id":"NTg3MwTr"}Success response: Dynamic pricingSuccess|NTg3MwTr|$10.00Success response: Dynamic pricing (response_type must be in "json" format){"status":"Success","ping_response_id":"NTg3MwTr","price":"10.00"}Success response: Shared leads-dynamic pricing: (response_type must be in "json" format){"status":"Success","ping_response_id":"NTg3MwTr","price":"10.00","legs_to_buy":"2","company_hashes":["15050c2c7cbe53c362be8e883a771c271bcf2ad4"]}Rejected Response:Rejected|NTg3MwTr|No Contractor FoundRejected Response: (response_type must be in "json" format){"status":"Rejected","ping_response_id":"NTg3MwTr","errors":["No Contractor Found"]}Other Error/Rejected ResponseRejected|Missing main category(response_type must be in "json" format){"status":"Rejected","errors":["Missing main category"]}Testing : We don’t store TEST leads. This is for you to test and troubleshoot responses. After testing, please send your tests over so that we can review on our end and confirm that you can go live if all is well.Use parameter testMode=1Test Mode Response: Success|NTg3MwTr|$10.00|Test LeadTest Mode Response: (response_type must be in "json" format) {"status":"Success","ping_response_id":"NTg3MwTr","price":"10.00","testlead":"true"}Test Mode Response for shared leads: (response_type must be in "json" format) {"status":"Success","ping_response_id":"NTg3MwTr","price":"10.00","legs_to_buy":"2","company_hashes":["15050c2c7cbe53c362be8e883a771c271bcf2ad4"],"testlead":"true"}
Post Response
curl "https://api.samedaypros.com/post.php" \
--request POST \
--header "Content-Type: application/x-www-form-urlencoded" \
--data "ping_id=MTE2Nw==&aff_id=1&source_id=123&sub_aff_id=xyz&zip=29568&maincat=Additions&subcat=Kitchen Addition&ip=49.42.2425.42&shading=unknown&bill=345&credit_score=700&testMode=1&universal_lead_id=9252592ufjkoajf8fj83f&firstname=Max&lastname=Bolton&phone=4054245552&phone_type=1&email=max@example.com&address=456 anaheim street&project_desc=Please give me a call to discuss my project&project_complete_by=Timing is flexible&property_type=Home&homeowner=1&TCPA=1&TCPA_consent_language=By clicking the button below, I consent...&testMode=1"
Our system will respond in the format command below
Success Response:SuccessSuccess Response: (response_type must be in "json" format){"status":"Success"}Rejected Response:RejectedRejected Response: (response_type must be in "json" format){"status":"Rejected"}Other Error/Rejected ResponseRejected|Missing firstname(response_type must be in "json" format){"status":"Rejected","errors":["Missing firstname"]}
Ping URL: https://api.samedaypros.com/ping.php
Post URL: https://api.samedaypros.com/post.php
Query Parameters
| Ping Required | Post Required | Field | Contents | Values Allowed |
|---|---|---|---|---|
| Yes | Yes | aff_id | Assigned by Same Day Pros | Example: 999 |
| Yes | Yes | source_id | Any alpha-numeric value | Example: 9592rjiw |
| Yes | Yes | sub_aff_id | This field represents your sub-affiliate's id within your own system. Even if you do not use sub-affiliates, this is still required to represent different types of advertising or campaigns you are running to generate leads. | Example: fjf242 |
| Yes | Yes | zip | Zip Code | Example: 91210 |
| Yes | Yes | maincat | Click here to see all categories | Example: Remodeling |
| Yes | Yes | subcat | Click here to see all subcategories | Example: Kitchen Addition |
| Optional | Yes | ip | The user's IP address | Example: 49.42.2425.42 |
| Yes* | Yes* | windows_count | The number of windows. * If you are selling window leads, this information is required. |
Example: 1
|
| Yes* | Yes* | shading | Solar field * If you are selling solar leads, this information is required. |
Example: a_little
|
| Yes* | Yes* | utility_provider | Solar field * If you are selling solar leads, this information is required. |
Example: Southern california edison |
| Yes* | Yes* | bill | Solar field * If you are selling solar leads, this information is required. |
Example: 345 |
| Yes* | Yes* | credit_score | Solar field * If you are selling solar leads, this information is required. |
Example: 700 |
| Optional | Optional | source_id_info | Numeric Value | Example: 5
|
| Optional | Optional | shared_lead | 1 or 2 (1 : Shared Lead or 2 : No ) | Example: 1 |
| Optional | Optional | legs_sold | 1 (Note: Required if shared_lead=1) The number of legs already sold. | Example: 1 |
| Optional | Optional | legs_available | 3 (Note: Required if shared_lead=1) The number of legs available to be sold. | Example: 3 |
| Optional | Optional | hash_legs_sold | 310fjq0812gf242292f2fh28042fh2 | Example: Hashed phones numbers (Separated by commas if more than 1) If you're not sending this on Ping, please send "0". Please note that the Post must include the hashed sold legs phone numbers |
| Optional | Optional | universal_lead_id | Jornaya/Universal Lead ID | Example: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX |
| Optional | Yes | trusted_form_url | Trusted Form URL |
Example: https://cert.trustedform.com/xxxxxxxx Unsure about what Trusted Forms is? Start Here
|
| Optional | Optional | landing_page | Where the user filled out the form? | Example: https://www.samedaypros.com |
| Optional | Optional | user_agent | User Agent from browser | Example: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36 |
| Optional | Optional | response_type | Response Type | Example: json |
| Optional | Yes | TCPA | 1 or 2 (1 : Yes or 2 : No ) | ex. 1 |
| Optional | Yes | TCPA_consent_language | your TCPA consent language. (if TCPA = 1) | Example: By clicking the button below, I consent that as part of the process to receive free no obligation quotes, a representative from home improvement companies and their partners will contact me and the phone number provided... |
| Optional | Yes | ping_id | Same Day Pros provided code in ping response | Example: NTg3MwTr |
| Optional | Yes | firstname | The user's first name | Example: Max |
| Optional | Yes | lastname | The user's last name | Example: Bolton |
| Optional | Yes | phone | The user's phone number | Example: 4054245552 |
| Optional | Yes | phone_type | The user's phone type | Example: 1
|
| Optional | Yes | The user's email address | Example: [email protected] | |
| Optional | Yes | address | The User’s Address | Example: 123 the wall street |
| Optional | Yes | project_desc | Project details | ex. I am looking to install new windows for my home |
| Optional | Yes | property_type | What type of property is this? |
|
| Optional | Yes | project_complete_by | Project hiring status |
|
| Optional | Yes | homeowner | Is the user a homeowner ? | 1=>Yes 2=>No |
| Optional | Optional | testMode | 0 or 1(0 : LIVE LEAD or 1 : TEST LEAD ) | ex. 1 |