Ping & Post Instructions
for Life Insurance
Let's Make A Lead API
Please use the following instructions to use our Ping/Post or Direct Post system for Life Insurance Vertical.
In order to get identified, you will need to send the following parameters:
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 |
3001 - Final Expense 3002 - Whole Life Insurance 3003 - Universal Life Insurance 3004 - Variable Life Insurance 3005 - Term Life Insurance show all |
3001 |
| 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 |
| 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 Life Insurance
| Ping Required |
Post Required |
fieldname | Value - Label | Example of value | |
|---|---|---|---|---|---|
| YES | YES | ip 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
varchar(50) | 198.50.155.124 | |
| YES | YES | tcpa_optin 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
1 (Yes) or 2 (No) Set. Allowed values: 1 - Yes 2 - No |
1 | |
| YES | YES | tcpa_text 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
varchar(5000) | Your TCPA language | |
| YES | YES | zipcode 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
varchar(5) | 33139 | |
| YES | YES | gender 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 1 - Male 2 - Female |
1 | |
| YES | YES | have_preexisting_medical_conditions 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense complementary datas are requireds if have_preexisting_medical_conditions is sent and ≠ 0  display complementary datas |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | tobacco 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
1 | |
| YES | YES | height 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer (Inches and greater than 10) |
70 | |
| YES | YES | weight 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer (Pounds) |
165 | |
| YES | YES | birth_date 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
date YYYY-MM-DD | 1982-10-15 | |
| YES | YES | occupation 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 1 - Advertising/Public Relations 2 - Arts/Entertainment/Publishing 3 - Banking/Mortgage 4 - Clerical 5 - Clergy/Religious show all |
26 | |
| YES | YES | coverage_amount 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer | 50000 | |
| YES | YES | coverage_duration 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 1 - Less than 1 Year 2 - 1-5 years 3 - 6-10 years 4 - 11-15 years 5 - 16-20 years show all |
8 | |
| YES | YES | currently_insured 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense complementary datas are requireds if currently_insured is sent and ≠ 0 display complementary datas |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | maritalstatus 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 1 - Single 2 - Married |
1 | |
| YES | YES | education 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 1 - Less than High School 2 - Some or No High School 3 - High School Diploma 4 - Some College 5 - College show all |
3 | |
| YES | YES | ownership 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 1 - Own 2 - Rent 3 - Other |
1 | |
| YES | YES | years_at_current_residence 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer | 3 | |
| YES | YES | hazardous_activity 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | hazard_felony 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | hazard_pilot 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | hazard_other 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | dui 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | hospitalized 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | prescriptions 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense complementary datas are requireds if prescriptions is sent and ≠ 0 display complementary datas |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | relative_heart 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
1 | |
| YES | YES | relative_cancer 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | ongoing_medical_treatment 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 0 - No 1 - Yes |
0 | |
| YES | YES | relationship_to_applicant 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
integer Set. Allowed values: 1 - Self 2 - Child 3 - Spouse 4 - Grandchild 5 - Grandparent show all |
1 | |
| NO | YES | firstname 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
varchar(50) | John | |
| NO | YES | lastname 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
varchar(50) | Doe | |
| NO | YES | address 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
varchar(255) | 1210 Ocean Drive | |
| NO | YES | telephone 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
varchar(20) | 8772681223 | |
| NO | YES | email 💡Requiered for categories : 3011 - Cash Value Life Insurance 3010 - Accidental Death and Dismemberment Insurance 3009 - Life Insurance Investment 3008 - Burial Insurance 3007 - Guaranteed Issue Life Insurance 3006 - Adjustable Life Insurance 3005 - Term Life Insurance 3004 - Variable Life Insurance 3003 - Universal Life Insurance 3002 - Whole Life Insurance 3001 - Final Expense |
varchar(50) | john.doe@gmail.com | |
| NO | NO | requested_term_period 💡Requiered for categories : 3005 - Term Life Insurance |
integer | 5 | |
| NO | OPTION | comments | varchar(500) | Free comment | |
| NO | OPTION | customid | varchar(50) - Your custom Id | 12345 | |
| NO | OPTION | city | varchar(50) | Miami | |
| OPTION | NO | trusted_form_available | 1 (Yes) | 1 (for Yes) or 0 (for No) | |
| OPTION | NO | universal_leadid_available | 1 (Yes) | 1 (for Yes) or 0 (for No) | |
| OPTION | OPTION | lead_born_datetime | Y-m-d h:i:s | 2023-01-01 11:50:23 | |
| OPTION | OPTION | hereditary_risk | integer Set. Allowed values: 0 - No 1 - Yes |
1 | |
| OPTION | OPTION | international_travel | integer Set. Allowed values: 0 - No 1 - Yes |
1 | |
| OPTION | OPTION | lifestyle_activity | integer Set. Allowed values: 0 - No 1 - Yes |
1 | |
| OPTION | OPTION | lifestyle_risk | integer Set. Allowed values: 0 - No 1 - Yes |
1 | |
| OPTION | OPTION | moving_violation | integer Set. Allowed values: 0 - No 1 - Yes |
1 | |
| OPTION | OPTION | tobacco_time | integer Set. Allowed values: 1 - Currently 2 - Within the Past Year 3 - Over a Year Ago 4 - Over 3 Years ago 5 - Over 5 Years ago |
1 | |
| OPTION | OPTION | tobacco_type | integer Set. Allowed values: 1 - Cigarrettes 2 - Cigars 3 - Pipes 4 - Chewing Tobacco 5 - Nicotine Patch or Gum show all |
1 | |
| OPTION | OPTION | trusted_form_token | varchar(250) | 544fa56524d00e3a0cb321b988fc40d8c42c7160 | |
| OPTION | OPTION | universal_leadid | varchar(50) | AB6A63B1-09A6-5AA3-85BD-CBDA909D9BBE | |
| 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 | previously_denied | integer Set. Allowed values: 0 - No 1 - Yes |
0 |
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.
You can call the PING API using three different methods:
Required Fields
When making a PING request, the following fields are mandatory and must be included:
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:
| TEST MODE |
|---|
|
Only For test Mode please :
|
| #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, .
When making a POST request, the following fields are mandatory and must be included:
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: