LegalFish

API Function: Direct Post

  1. Home
  2. API Function: Direct Post

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 instructions.

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 customer.

Note: Not sending optional fields () will not result in an error.

Do not begin posting leads to Legal Fish 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 Legal Fish without confirmation from your account manager will not be counted as a billable lead and will be returned.

Post URL : https://api.legalfish.us/directpost.php

Note : We accept only HTTP/1.1 POST Request

Required Field Contents Values Allowed
Yes vid Provided by Legal Fish ex. 101
Optional universal_lead_id Any alpha-numeric value (Jornaya) ex. 480248-AER4-242-JDOFHG
Yes source_id Any alpha-numeric value (When the lead came from) ex. 402fnfn
Optional source_id_info Numeric Value: 1=> pay per click | 2=> seo | 3=> call center | 4=> affiliate network | 5=> social media | 6=> third party ex. 1
Yes first_name The user's First name ex. Glenn
Yes last_name The user's Last name ex. Beck
Yes phone The user's phone number ex. 213456818
Yes phone_type What is the user's phone type? | 1=> Mobile | 2=> Non-Mobile ex. 1
Yes address The user's home address ex. 874 lexingto street
Yes email The user's email address ex. glenn.beck@noemail.com
Yes issue_description Summary of the case/issue of the user's legal problem. ex. I need an attorney to help me with my divorce.
Yes zip Geographic location ex. 91316
Yes shared_lead Numeric Value: 1=> Yes | 2=> No ex. 2
Yes legal_category Valid category (click link to access all categories) | Use Numeric Value ex. 10
Yes legal_subcategory Valid category (click link to access all categories) | Use Numeric Value ex. 13
Yes spoke_to_attorney Has the lead spoken to a previous attorney? 1=> Yes | 2=> No ex. 2
Optional attorney_payment Can the user afford legal representation?
1 => Can afford | 2 => Can't afford		 ex. 1
Optional trusted_form_url Trusted Form URL ex. https://cert.trustedform.com/xxxxxxxx
Optional landing_page Where the user filled out the form? ex. https://www.legalfish.com
Optional user_agent User Agent from browser ex. Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36
Optional incident_timeframe[1] When did the incident occur?
Values Allowed:
Recently | 3-6 months ago | 6-12 months ago | More than 1 year ago 		ex. 3-6 months ago
Optional was_it_your_fault[2] Was the accident your fault? 1=> Yes | 2=> No ex. 1
Optional damages[2] 1K | 1K-2K | 2K-3K | 3K-4K | 4K-5K | 5K-7K | 7K-10K | 10K-15K | 15K+ ex. 3K-4K
Optional police_report_filed[2] 1=> Yes | 2=> No ex. 1
Optional were_you_injured[2] 1=> Yes | 2=> No ex. 1
Optional doctor_treatment[3] 1=> Yes | 2=> No ex. 1
Optional debt[4] less than 5K | 5K-10K | 10K-20K | 20K-50K | 50K+ ex. less than 5K
Optional income_monthly[5] less than 1K | 1K-2K | 2K-3K | 3K-4K | 4K-5K | 5K-7K | 7K-10K | 10K-15K | 15K+ ex. 2K-3K
Optional assets[5] less than 50K | 50K-100K | 100K-250K | 250K-500K | 500K-1M | 1M+ ex. 1M+
Optional property_owner[6] 1=> Yes | 2=> No ex. 1
Optional immigration_type[7] Citizenship | Permanent Visa | Temporary Visa | Deportation | Other ex. Citizenship
Optional immigration_status[7] Living in the US with proper docs | Living in the US without proper docs | Living outside the USA | Currently facing deportation ex. Living in the US with proper docs
Optional hours_reduced[8] 1=> Yes | 2=> No ex. 1
Optional user_age[8] Numeric Value ex. 43
Optional applied_previously[8] 1 = Yes, claim denied | 2 = Yes, claim pending | 3 = No ex. 2
Optional benefits[8] 1=> Yes | 2=> No ex. 1
Optional condition[8] less than 1 year | 1-3 Years | 3-5 Years | 5 Years+ ex. 1-3 Years
Optional work_status[8] Is the user able to work?
1=> Yes | 2=> No		 ex. 1
Optional level_tax[9] State | Federal | Local ex. Federal
Optional type_tax[9] Income | Property | Corporate ex. Income
Optional total_tax_debt[9] less than 5K | 5K-10K | 10K-20K | 20K-50K | 50K+ ex. 5K-10K
Yes ip The user's IP address ex. 192.168.1.1
Yes tcpa_consent Numeric Value: 1=> Yes | 2=> No ex. 1
Yes tcpa_consent_language The language that the user saw/agreed to. ex. By clicking "Submit" I authorize a legal provider to contact me at the phone number...
Optional test_mode Numeric Value: 1=> Test Lead | 2=> Live Lead ex. 2
  1. ^Required if you're sending "Auto Accidents", "Dui", "Medical Malpractice", "Mesothelioma", "Nursing Home Abuse", "Personal Injury", "Police Brutality", "Workers Comp" leads.
  2. ^Required if you're sending "Auto Accidents" leads.
  3. ^Required if you're sending "Auto Accidents", "Medical Malpractice", "Mesothelioma", "Personal Injury", "Police Brutality", "SSDI or Social Security Disability", "Workers Comp" leads.
  4. ^Required if you're sending "Bankruptcy", "Tax Law" leads.
  5. ^Required if you're sending "Bankruptcy" leads.
  6. ^Required if you're sending "Bankruptcy", "Foreclosure Defense" leads.
  7. ^Required if you're sending "Immigration" leads.
  8. ^Required if you're sending "SSDI or Social Security Disability" leads.
  9. ^Required if you're sending "Tax Law" leads.
Legal Main Category Legal Sub Category
Auto Accidents : 1 Auto Accidents : 2
Bankruptcy : 3 Bankruptcy : 4
Business Law : 5 Business Law : 6
Civil Lawsuits : 7 Civil Lawsuit Defense : 8
Civil Lawsuits : 7 Discrimination/Harassment : 9
Consumer Law : 10 ID Theft : 11
Consumer Law : 10 Insurance Claims : 12
Consumer Law : 10 Consumer Law : 13
Consumer Law : 10 Lemon Law : 14
Criminal Defense : 15 Criminal Defense : 16
Criminal Defense : 15 Criminal Appeals : 17
Criminal Defense : 15 Criminal Expungement : 18
Criminal Defense : 15 Police Brutality : 19
Criminal Defense : 15 Victim of a crime : 20
Debt and Collection : 21 Debt Collector Harassment : 22
Debt and Collection : 21 Collections and Debt : 23
DUI : 24 DUI : 25
DUI : 24 Suspended License : 26
Family Law : 31 Divorce : 32
Family Law : 31 Child Custody : 33
Family Law : 31 Child Support : 34
Family Law : 31 Adoption : 35
Family Law : 31 Family Law : 36
Foreclosure Defense : 37 Foreclosure Defense : 38
ID Theft : 39 ID Theft : 40
Immigration : 41 Immigration : 42
Intellectual Property : 43 Copyrights/Trademarks : 44
Intellectual Property : 43 Patents : 45
Landlord/Tenant : 46 Landlord/Tentant : 47
Landlord/Tenant : 46 Eviction : 48
Medical Malpractice : 49 Medical Malpractice : 50
Mesothelioma : 51 Mesothelioma : 52
Nursing Home Abuse : 53 Nursing Home Abuse : 54
Personal Injury : 55 Personal Injury : 56
Real Estate and Property Law : 57 Real Estate Disputes : 58
Real Estate and Property Law : 57 Property Disputes : 59
SSDI or Social Security Disability : 60 SSDI or Social Security Disability : 61
Tax Law : 62 Tax Law : 63
Traffic Violations : 64 Traffic Law : 65
Traffic Violations : 64 Suspended License : 66
Workers Comp : 67 Workers Comp : 68
Wrongful Termination : 69 Wrongful Termination : 70
Wills/Trusts : 71 Wills/Trusts : 72
Estates/Probate : 73 Estates/Probate : 74
Power of Attorney : 75 Power of Attorney : 76
Legal Contract : 77 Document Review or Legal Contract : 78
Contracts : 79 Business Law/Contracts/Agreements/Breaches : 80
Corporate Law : 81 Business Law/Incorporation/Corporate Law : 82
Father's Rights : 83 Father's Rights : 84
Small Business : 85 Small Business : 86
Employment : 87 Employment Law : 88

POST :

Request :

POST URL: https://api.legalfish.us/directpost.php

Accept: text/html

Content-Type: application/x-www-form-urlencoded

Content :

vid=1&universal_lead_id=480248-AER4-242-JDOFHG&source_id=123&source_id_info=1&zip=29568&ip=192.168.0.1
&shared_lead=1&spoke_to_attorney=1&tcpa_consent=1&first_name=test&last_name=test&phone=3047657096
&phone_type=1&email=abc2@gmail.com&address=874+lexingto+street&issue_description=lip+sum
&tcpa_consent_language=By+clicking+"Submit"+I...&legal_category=31&legal_subcategory=33&test_mode=2

Response :

Success Response:

{"status":"success","lead_response_id":"MzUwODY0MDY="}

Rejected response:

{"status":"rejected","lead_response_id":"MzUwODY0MDE=","errors":["No Buyer Found"]}

Rejected response due to an error:

{"status":"rejected","errors":["Missing legal_category","Missing zip"]}

Test Mode :

Use parameter test_mode=1

Test Mode Response:

{"status":"success","lead_response_id":"MTExNw==","testlead":"true"}