Ping & Post API

Posting Instructions Fields Required Ping API Post
Health Ins. Home Ins. Legal Auto Ins. Home Services Life ins. Finance / Debt.
Calls
Call Home services Call Auto Ins. Call Health Ins. Call Legal. Call Finance/Debt.

Ping & Post Instructions
for Auto Insurance

Let's Make A Lead API
Please use the following instructions to use our Ping/Post or Direct Post system for Auto Insurance Vertical.
In order to get identified, you will need to send the following parameters:
Ping
Required 		Post
Required 		field Contents Example of value
YES YES partnerid Will be provided XYZ
YES YES key Will be provided 771f5924706521c73464341fc48afb05
YES YES numcategory 1003 - Auto Insurance   
1003
YES YES subid Your sub Source 123
OPTION OPTION resptype 'XML' to receive an XML response.
'JSON' to receive an JSON response.
if empty, the response format will be by default. 		XML
YES price The payout for the lead in $.
 0.15
NO OPTION price_tag 1 to receive the Price inside the Post response.
if empty, the response format will be by default. (See response example)		 1
NO YES token Value you received in case of positive Ping.
Must be sent on the Post.		 e69412030cc93b47cf5be6f7e3ee998c
Fields Required for Auto Insurance
Ping
Required 		Post
Required 		fieldname Value - Label Example of value
YES YES ip varchar(50) 10.0.0.1
YES YES zipcode varchar(5) 33139
YES YES current_policy_insurance_company
complementary datas are requireds if current_policy_insurance_company is sent and ≠ 0
display complementary datas
 integer
Please, Send 0 if Not Insured
 Set. Allowed values:
0 - Not Currently Insured
1 - Not Listed
2 - 21st Century
3 - AAA
4 - AABCO

show all 		0
YES YES driver1
complementary datas are requireds if driver1 is sent and ≠ 0
display complementary datas
 integer Set. Allowed values:
1 - Yes
1
YES YES requested_policy_coverage_type integer Set. Allowed values:
1 - Preferred
2 - Premium
3 - Standard
4 - State Minimum
1
YES YES requested_policy_property_damage integer 10000
YES YES vehicle1
complementary datas are requireds if vehicle1 is sent and ≠ 0
display complementary datas
 integer Set. Allowed values:
1 - Yes
1
YES YES tcpa_optin 1 (Yes) or 2 (No) 1
NO YES tcpa_text varchar(5000) The TCPA Text of the Lead
NO YES firstname varchar(50) John
NO YES lastname varchar(50) Doe
NO YES email varchar(255) johndoe@gmail.fr
NO YES telephone varchar(10) 8772681223
NO YES address varchar(255) 1210 Ocean Drive
NO YES city varchar(50) Miami
NO YES state varchar(2) FL
NO OPTION customid varchar(50) - Your custom Id 12345
NO OPTION telephone2 varchar(10) 8772681223
NO OPTION address2 varchar(255) suite #1002
OPTION NO phone_last_four varchar(4) 2369
OPTION NO trusted_form_available 1 (Yes) 0
OPTION NO universal_leadid_available 1 (Yes) 0
OPTION OPTION lead_born_datetime Y-m-d h:i:s 2023-01-01 11:50:23
OPTION OPTION shared
complementary datas are requireds if shared is sent and ≠ 0
display complementary datas
 1 (Yes) 0
OPTION OPTION trusted_form_token 544fa56524d00e3a0cb321b988fc40d8c42c7160
OPTION OPTION universal_leadid varchar(50) FFEA9CB6-1A2D-9DA3-0188-96A93D26875C
OPTION OPTION user_agent varchar(255) Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36
OPTION OPTION driver2
complementary datas are requireds if driver2 is sent and ≠ 0
display complementary datas
 integer Set. Allowed values:
0 - No
1 - Yes
0
OPTION OPTION vehicle2
complementary datas are requireds if vehicle2 is sent and ≠ 0
display complementary datas
 integer Set. Allowed values:
0 - No
1 - Yes
0
OPTION OPTION 1to1consent
complementary datas are requireds if 1to1consent is sent and ≠ 0
display complementary datas
 0 (No), 1 (Yes). 0 by default 0
OPTION OPTION credit_rating Set. Allowed values:
1 - Poor
2 - Fair
3 - Good
4 - Excellent
1
OPTION OPTION requested_policy_bodily_injury integer Set. Allowed values:
1 - 25/50
2 - 50/100
3 - 100/300
4 - 250/500
1
OPTION OPTION driver3
complementary datas are requireds if driver3 is sent and ≠ 0
display complementary datas
 integer Set. Allowed values:
0 - No
1 - Yes
0
OPTION OPTION vehicle3
complementary datas are requireds if vehicle3 is sent and ≠ 0
display complementary datas
 integer Set. Allowed values:
0 - No
1 - Yes
0
OPTION OPTION comment varchar(500) Your Comment here
PING API
Methods
You can call the PING API using three different methods:
  • cURL POST with URL-encoded data
  • cURL POST with JSON data
  • HTTP GET request

    Required Fields
    When making a PING request, the following fields are mandatory and must be included:
  • partnerid: Your unique partner ID.
  • key: Your API key for authentication.
  • numcategory: The category number for the service.
  • subid: Your unique sub ID.

    • In addition to the fields mentioned above, all fields marked as "Ping Required" with Yes in the "Fields Required" table above must also be included in the request.

    Response
    The API will respond in one of the following ways:
  • Accepted: We will return a price and a token that you can reuse in the POST API.
  • Rejected: The request will be rejected with a detailed reason provided in the response.
    TEST MODE
    Only For test Mode please :
  • use key = test_mode (The Live Mode Key will be provided upon completion of successful Test.)
  • use subid = match To simulate a positive response
    • For direct post according to a ziplist
  • add price = 0.5
    • #errorCode# Meaning
    1000 Server under maintenance
    1100 Request limit exceeded
    2000 Invalid Partner ID or Blocked source
    3000 Approval Phase
    4000 Daily Cap reached
    5000 No coverage or buyers
    6000 Minimum bid not met
    Other Ask Your Representative
    POST API
    Required Fields
    When making a POST request, the following fields are mandatory and must be included:
  • partnerid: Your unique partner ID.
  • key: Your API key for authentication.
  • numcategory: The category number for the service.
  • subid: Your unique sub ID.
  • token: the token received on the Ping response.

    • In addition to the fields mentioned above, all fields marked as "Post Required" with Yes in the "Fields Required" table above must also be included in the request.

    Response
    The post API will respond in one of the following ways:
  • Accepted: see examples...
  • Rejected: if the leads is post rejected, .

    • jerems18