Ping & Post API

Posting Instructions Fields Required Ping API Post One Step System
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 Call Routing Legal

Let's Make A Lead API
Please use the following instructions to use our Ping/Post or Direct Post system for Call Routing Legal 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 16001 - Call Routing Auto Accidents   
16002 - Call Routing Bankruptcy   
16003 - Call Routing Business Law   
16004 - Call Routing Civil Lawsuits - Civil Lawsuit Defense   
16005 - Call Routing Civil Lawsuits - Discrimination/Harassment   
show all 		16001
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 Call Routing Legal
Ping
Required 		Post
Required 		fieldname Value - Label Example of value
YES YES transfer_type integer Set. Allowed values:
1 - Inbounds
2 - Transfers
1
YES YES zipcode varchar(5) 33139
NO OPTION state varchar(2) FL
NO OPTION firstname varchar(50) John
NO OPTION lastname varchar(50) Doe
NO OPTION address varchar(100) 1210 Ocean Drive
NO OPTION city varchar(100) Miami
NO OPTION telephone varchar(50) 8772681223
NO OPTION email varchar(50) john.doe@gmail.com
NO OPTION comments varchar(500) Free comment
NO OPTION customid varchar(50) 12345
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. For call routing, you also receive a call duration linked to the price (the minimum duration required to validate the call).
  • 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:
    PhoneNumber received on post response
    The call have to be forwarded to the provided PhoneNumber in the next 30 seconds
  • Rejected: if the leads is post rejected, .
    • ONE STEP SYSTEM
    The One-Step Method is a quick and easy way to get a phone number to transfer a call.

    By using the API endpoint http://call.letsmakealead.com/Ping_Partner_CR.php, you will receive all the necessary details in one step.

    Along with the offer and call duration, the response will include the phone number to transfer the call immediately if the offer is accepted.

    This saves time and simplifies the process.

    jerems17