LegalFish

API Function: Ping/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.

Ping URL : https://api.legalfish.us/ping.php

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

Note : We accept only HTTP/1.1 POST Request

Ping / Post Fields
Category Details

Ping Required	Post Required	Field	Contents	Values Allowed
Yes	Yes	vid	Provided by Legal Fish	ex. 101
Optional	Optional	universal_lead_id	Any alpha-numeric value (Jornaya)	ex. 480248-AER4-242-JDOFHG
Yes	Yes	source_id	Any alpha-numeric value (Where the lead came from)	ex. 402fnfn
Optional	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	Yes	zip	Geographic location	ex. 91316
Yes	Yes	shared_lead	Numeric Value: 1=> Yes \| 2=> No	ex. 2
Yes	Yes	legal_category	Valid category (click link to access all categories) \| Use Numeric Value	ex. 10
Yes	Yes	legal_subcategory	Valid category (click link to access all categories) \| Use Numeric Value	ex. 13
Yes	Yes	spoke_to_attorney	Has the lead spoken to a previous attorney? 1=> Yes \| 2=> No	ex. 2
Optional	Optional	attorney_payment	Can the user afford legal representation? 1 => Can afford \| 2 => Can't afford	ex. 1
Optional	Optional	trusted_form_url	Trusted Form URL	ex. https://cert.trustedform.com/xxxxxxxx
Optional	Optional	landing_page	Where the user filled out the form?	ex. https://www.legalfish.com
Optional	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	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 \| Less than 2 years	ex. 3-6 months ago
Optional	Optional	was_it_your_fault^[2]	Was the accident your fault? 1=> Yes \| 2=> No	ex. 1
Optional	Optional	damages^[2]	1K \| 1K-2K \| 2K-3K \| 3K-4K \| 4K-5K \| 5K-7K \| 7K-10K \| 10K-15K \| 15K+	ex. 3K-4K
Optional	Optional	police_report_filed^[2]	1=> Yes \| 2=> No	ex. 1
Optional	Optional	were_you_injured^[2]	1=> Yes \| 2=> No	ex. 1
Optional	Optional	doctor_treatment^[3]	1=> Yes \| 2=> No	ex. 1
Optional	Optional	debt^[4]	less than 5K \| 5K-10K \| 10K-20K \| 20K-50K \| 50K+	ex. less than 5K
Optional	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	Optional	assets^[5]	less than 50K \| 50K-100K \| 100K-250K \| 250K-500K \| 500K-1M \| 1M+	ex. 1M+
Optional	Optional	property_owner^[6]	1=> Yes \| 2=> No	ex. 1
Optional	Optional	immigration_type^[7]	Citizenship \| Permanent Visa \| Temporary Visa \| Deportation \| Other	ex. Citizenship
Optional	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	Optional	hours_reduced^[8]	1=> Yes \| 2=> No	ex. 1
Optional	Optional	user_age^[8]	Numeric Value	ex. 43
Optional	Optional	applied_previously^[8]	1 = Yes, claim denied \| 2 = Yes, claim pending \| 3 = No	ex. 2
Optional	Optional	benefits^[8]	1=> Yes \| 2=> No	ex. 1
Optional	Optional	condition^[8]	less than 1 year \| 1-3 Years \| 3-5 Years \| 5 Years+	ex. 1-3 Years
Optional	Optional	work_status^[8]	Is the user able to work? 1=> Yes \| 2=> No	ex. 1
Optional	Optional	level_tax^[9]	State \| Federal \| Local	ex. Federal
Optional	Optional	type_tax^[9]	Income \| Property \| Corporate	ex. Income
Optional	Optional	total_tax_debt^[9]	less than 5K \| 5K-10K \| 10K-20K \| 20K-50K \| 50K+	ex. 5K-10K
Optional	Yes	ping_response_id	Provided by Legal Fish in the ping response.	ex. rjjff2nf882
Optional	Yes	first_name	The user's First name	ex. Glenn
Optional	Yes	last_name	The user's Last name	ex. Beck
Optional	Yes	phone	The user's phone number	ex. 213456818
Optional	Yes	phone_type	What is the user's phone type? \| 1=> Mobile \| 2=> Non-Mobile	ex. 1
Optional	Yes	address	The user's home address	ex. 874 lexingto street
Optional	Yes	email^[10]	The user's email address	ex. glenn.beck@noemail.com Hashed Email is optional. Must be submitted in md5. Hashed value is only at the Ping level. We require the user's real email address on Post.
Optional	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	Yes	ip	The user's IP address	ex. 192.168.1.1
Yes	Yes	tcpa_consent	Numeric Value: 1=> Yes \| 2=> No	ex. 1
Optional	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	Optional	test_mode	Numeric Value: 1=> Test Lead \| 2=> Live Lead	ex. 2
^Required if you're sending "Auto Accidents", "Dui", "Medical Malpractice", "Mesothelioma", "Nursing Home Abuse", "Personal Injury", "Police Brutality", "Workers Comp" leads on PING and POST ^Required if you're sending "Auto Accidents" leads on PING and POST ^Required if you're sending "Auto Accidents", "Medical Malpractice", "Mesothelioma", "Personal Injury", "Police Brutality", "SSDI or Social Security Disability", "Workers Comp" leads on PING and POST ^Required if you're sending "Bankruptcy", "Tax Law" leads on PING and POST ^Required if you're sending "Bankruptcy" leads on PING and POST ^Required if you're sending "Bankruptcy", "Foreclosure Defense" leads on PING and POST ^Required if you're sending "Immigration" leads on PING and POST ^Required if you're sending "SSDI or Social Security Disability" leads on PING and POST ^Required if you're sending "Tax Law" leads on PING and POST ^Required if you're sending "Bankruptcy" leads on PING

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

PING :

Request :


                        PING URL: https://api.legalfish.us/ping.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&legal_category=1&legal_subcategory=2&
spoke_to_attorney=1&tcpa_consent=1

Response :


                        Success Response:
                        {"status":"success","ping_response_id":"MzUwODY0MDY="}
                        Success response if you're selling to us via dynamic pricing:
                        {"status":"success","ping_response_id":"MzUwODY0MDY=","price":"10.00"}
                        Rejected response:
                        {"status":"rejected","ping_response_id":"MzUwODY0MDE=","errors":["No Buyer Found"]}
                        Rejected response due to an error:
                        {"status":"rejected","errors":["Missing legal_category","Missing zip"]}
                        Note: We have the ability to purchase leads via fixed or dynamic pricing. 

                            Simply notify your account manager and further instructions will be provided.

Test Mode :


                        Use parameter test_mode=1

Test Mode Response:


                        {"status":"success","ping_response_id":"MTExNw==","price":"10.00","testlead":"true"}

POST :

Request :


                        POST URL: https://api.legalfish.us/post.php
                        Accept: text/html
                        Content-Type: application/x-www-form-urlencoded
                        Content :
                        ping_response_id=NTg3MwTr&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&legal_category=1&legal_subcategory=2&

                            spoke_to_attorney=1&tcpa_consent=1&first_name=Glenn&last_name=Beck&phone=8654679857&phone_type=1&

                            email=abc@gmail.com&address=874+lexingto+street&issue_description=lip+sum&

                            tcpa_consent_language=By+clicking+"Submit"+I+authorize+a+legal+provider+to+contact+me+at+the+phone+

                            number+above+regarding+my+legal+issue.+Contact+may+be+by+live+agent,+autodialed+and/or+prerecorded,+

                            and/or+SMS+text.+I+understand+consent+is+not+a+condition.

Response :


                        If lead is success and accepted response will be as
                        {"status":"success"}
                        If lead is rejected, response will be as
                        {"status":"rejected","ping_response_id":"MzUwODY0MDc=","errors":["No Buyer Found"]}
                        If lead is rejected and there is error, response will be as 
                        {"status":"rejected","ping_response_id":"MzUwODY0MDc=","errors":["Missing first_name"]}