Difference between revisions of "Send Lead API"

From Netsville Support
Jump to navigation Jump to search
Line 1: Line 1:
 +
=Overview=
 +
This is a work in progress.  This document describes how to submit leads directly to Netsville via an HTTP POST Request.  Requests are submitted to a CGI script with Key-Value Pairs in the BODY of the request.
 +
 +
=Request Requirements=
 +
 +
Only '''POST''' requests are allowed.
 +
 +
=Test Server=
 +
Currently, just the testing server is available.  Here is the main URI:
 +
 +
http://devel3.netsville.com/us-social-security-disability.com/admin/sendlead.php
 +
 +
=Description of Form Fields=
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
!Field||Description||Type||Required||Example
 
!Field||Description||Type||Required||Example
Line 21: Line 35:
 
|-
 
|-
 
|addr_zip||Zip code (5 number)||Numeric||Yes||14614
 
|addr_zip||Zip code (5 number)||Numeric||Yes||14614
 +
|-
 +
|disability||What is the condition that prevents you from working?||Alpha||Yes||A-Fib, heart condition, dizziness
 +
|-
 +
|out_of_work_yn||Do you expect to be out of work for the next 12 months?<br>Either Yes(Y) or No(N)||Alpha||Yes||Y
 +
|-
 +
|stop_work_date||The date that you stopped working in YYYY-MM-DD format||Date||Yes||2009-11-30
 
|-
 
|-
 
|applied_yn||Have you applied for Social Security Disability?<br>Either Yes(Y) or No(N)||Alpha||Yes||Y
 
|applied_yn||Have you applied for Social Security Disability?<br>Either Yes(Y) or No(N)||Alpha||Yes||Y
Line 28: Line 48:
 
|applied_denial_date||If the above answer contains 'denied', then this field must contain the date of that denial in the format: YYYY-MM-DD.  Otherwise, this field can be empty.||Date||No||2010-12-31
 
|applied_denial_date||If the above answer contains 'denied', then this field must contain the date of that denial in the format: YYYY-MM-DD.  Otherwise, this field can be empty.||Date||No||2010-12-31
 
|-
 
|-
|out_of_work_yn||Do you expect to be out of work for the next 12 months?<br>Either Yes(Y) or No(N)||Alpha||Yes||Y
+
|work_half_yn||Have you worked 5 out of the last 10 years? This field can be empty.||Alpha||No||N
|-
 
|stop_work_date||The date that you stopped working in YYYY-MM-DD format||Date||Yes||2009-11-30
 
|-
 
|work_half_yn||Have you worked 5 out of the last 10 years? This field can be empty.||Alpha||No||Y -or- N
 
|disability||What is the condition that prevents you from working?||Alpha||Yes||A-Fib, heart condition, dizziness
 
 
|-
 
|-
 
|talk_to_lawyer_yn||Would you like a free consultation (speak to a laywer)? If this is blank, YES(Y) is assumed.||Alpha||No||Y
 
|talk_to_lawyer_yn||Would you like a free consultation (speak to a laywer)? If this is blank, YES(Y) is assumed.||Alpha||No||Y

Revision as of 14:57, 23 August 2013

Overview

This is a work in progress. This document describes how to submit leads directly to Netsville via an HTTP POST Request. Requests are submitted to a CGI script with Key-Value Pairs in the BODY of the request.

Request Requirements

Only POST requests are allowed.

Test Server

Currently, just the testing server is available. Here is the main URI:

http://devel3.netsville.com/us-social-security-disability.com/admin/sendlead.php

Description of Form Fields

Field Description Type Required Example
affiliate_id Unique identifier given to you by Netsville Alphanumeric Yes ABC123
name_last Last Name of Person Alpha Yes Smith
name_first First Name of Person Alpha Yes John
dob Date of Birth in YYYY-MM-DD format Date Yes 1985-01-15
email Email address Email Yes jsmith@example.com
phone_home 10 digit home phone number in NNNXXXYYYY format (numbers only) Numeric Yes 5855551212
addr_street Street address Alphanumeric Yes 123 Main Street
addr_city City Alpha Yes Rochester
addr_state State (two letter abbreviation) Alpha Yes NY
addr_zip Zip code (5 number) Numeric Yes 14614
disability What is the condition that prevents you from working? Alpha Yes A-Fib, heart condition, dizziness
out_of_work_yn Do you expect to be out of work for the next 12 months?
Either Yes(Y) or No(N)
Alpha Yes Y
stop_work_date The date that you stopped working in YYYY-MM-DD format Date Yes 2009-11-30
applied_yn Have you applied for Social Security Disability?
Either Yes(Y) or No(N)
Alpha Yes Y
applied_result What was the result of your application? The possible choices are: Claim Pending, Receiving Benefits, Claim Denied.
The answer must contain one of these words: 'pending', 'benefits', or 'denied'
Alpha Yes denied
applied_denial_date If the above answer contains 'denied', then this field must contain the date of that denial in the format: YYYY-MM-DD. Otherwise, this field can be empty. Date No 2010-12-31
work_half_yn Have you worked 5 out of the last 10 years? This field can be empty. Alpha No N
talk_to_lawyer_yn Would you like a free consultation (speak to a laywer)? If this is blank, YES(Y) is assumed. Alpha No Y
doc_yn In the past 6 months, have you seen a doctor?
Either Yes(Y) or No(N). This field can be empty.
Alpha No N
have_lawyer_yn Do you currently have an attorney helping you?
Either Yes(Y) or No(N). This field can be empty.
Alpha No N
is_test_lead A trigger to mark lead as only a test in the database. Use '1' for Yes and '0' for No. This field can be empty. Numeric No 0