Search leads

curl --request GET \
  --url https://app.leadconduit.com/search/leads \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://app.leadconduit.com/search/leads"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://app.leadconduit.com/search/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.leadconduit.com/search/leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.leadconduit.com/search/leads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.leadconduit.com/search/leads")
  .header("Authorization", "Basic <encoded-value>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.leadconduit.com/search/leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "hits": [
    {
      "lead_id": "5fd4371e940df5a34a3888b2",
      "flow_id": "5fd4371e940df5a34a3888b2",
      "flow_name": "Sales Leads",
      "source_id": "5fd4371e940df5a34a3888b2",
      "source_name": "A Corporation",
      "first_name": "George",
      "last_name": "Washington",
      "email": "georgew@gmail.com",
      "phone_1": "5125551212",
      "phone_2": "5125552222",
      "address_1": "123 Main street",
      "city": "Austin",
      "postal_code": "78704",
      "reference": "1990118214561",
      "state": "TX",
      "submission_timestamp": "2023-11-07T05:31:56Z",
      "highlight": {},
      "latest_event": {
        "id": "5fd4371e940df5a34a3888b2",
        "reason": "<string>",
        "type": "recipient",
        "vars": {
          "price": 123,
          "purchase_price": 123,
          "event_id": "636999a5a28de89048cd16fc"
        },
        "host": "<string>",
        "start_timestamp": 123,
        "end_timestamp": 123,
        "firehose": {
          "credential_id": "5fd4371e940df5a34a3888b2",
          "enabled": true,
          "bucket": "<string>",
          "prefix": "<string>",
          "services": {
            "aws": {
              "enabled": true,
              "credential_id": "5fd4371e940df5a34a3888b2",
              "bucket": "<string>",
              "prefix": "<string>"
            },
            "azure": {
              "enabled": true,
              "credential_id": "5fd4371e940df5a34a3888b2",
              "bucket": "<string>",
              "prefix": "<string>"
            }
          }
        },
        "ms": 123,
        "wait_ms": 123,
        "overhead_ms": 123,
        "lag_ms": 123,
        "total_ms": 123,
        "handler_version": "<string>",
        "version": "<string>",
        "cap_reached": true,
        "flow_ping_limits": {
          "id": "5fd4371e940df5a34a3888b2",
          "name": "<string>",
          "maximum": 123,
          "duration": 123,
          "duration_units": "<string>",
          "time_zone": "America/New_York",
          "created_at": "2023-11-07T05:31:56Z"
        },
        "source_ping_limits": {
          "id": "5fd4371e940df5a34a3888b2",
          "name": "<string>",
          "maximum": 123,
          "duration": 123,
          "duration_units": "<string>",
          "time_zone": "America/New_York",
          "created_at": "2023-11-07T05:31:56Z"
        },
        "ping_limit_reached": true,
        "expires_at": "2023-11-07T05:31:56Z",
        "step_id": "<string>",
        "caps": [
          {
            "id": "5fd438f91f0d12766e2bfee5",
            "type": "volume",
            "name": "Monthly leads from TX",
            "maximum": 1200,
            "duration": 2,
            "rule_set": {
              "rules": [
                {
                  "lhv": "lead.state",
                  "op": "is equal to",
                  "rhv": "TX",
                  "id": "1aacd0",
                  "rule_set": "<unknown>"
                }
              ],
              "id": "0d144a"
            },
            "caps": "<array>",
            "time_zone": "America/New_York",
            "reason": "<string>",
            "created_at": "2020-11-23T11:41:52Z"
          }
        ],
        "caps_reached": true,
        "key": "<string>",
        "cost": 123,
        "purchase_price": 123,
        "sale_price": 123,
        "revenue": 123,
        "module_id": "<string>",
        "credential": {
          "id": "5fd4371e940df5a34a3888b2",
          "name": "<string>",
          "type": "user",
          "package": "<string>",
          "username": "<string>",
          "password": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z"
        },
        "credential_updated": true,
        "package_version": "<string>",
        "rule_set": {
          "rules": [
            {
              "lhv": "lead.state",
              "op": "is equal to",
              "rhv": "TX",
              "id": "1aacd0",
              "rule_set": "<unknown>"
            }
          ],
          "id": "0d144a"
        },
        "mappings": [
          {
            "property": "<string>",
            "value": "<string>",
            "id": "1aacd0",
            "rule_set": {
              "rules": [
                {
                  "lhv": "lead.state",
                  "op": "is equal to",
                  "rhv": "TX",
                  "id": "1aacd0",
                  "rule_set": "<unknown>"
                }
              ],
              "id": "0d144a"
            }
          }
        ],
        "pricing": {
          "override": true,
          "prices": [
            {
              "amount": 123,
              "id": "<unknown>",
              "rule_set": {
                "rules": [
                  {
                    "lhv": "lead.state",
                    "op": "is equal to",
                    "rhv": "TX",
                    "id": "1aacd0",
                    "rule_set": "<unknown>"
                  }
                ],
                "id": "0d144a"
              }
            }
          ]
        },
        "transactions": [
          {
            "request": {
              "method": "POST",
              "uri": "https://app.leadconduit.com/flows/5fd4371e940df5a34a3888b2/sources/6369a0e534c9d4ebe142e0ef/submit",
              "version": "1.1",
              "headers": {
                "Content-Type": "application/json",
                "Accept": "application/json"
              },
              "body": "{\"email\":\"johndoe@email.com\",\"phone_1\":\"5127891111\"}",
              "timestamp": 123
            },
            "response": {
              "version": "1.1",
              "headers": {
                "Content-Type": "application/json",
                "Accept": "application/json"
              },
              "body": "{\"outcome\":\"success\",\"lead\":{\"id\":\"63cc6f0e55254d7d1c4c3037\"}}",
              "timestamp": 123,
              "status": 201,
              "status_text": "Created"
            },
            "ms": 123
          }
        ]
      }
    }
  ],
  "total": 123
}

Leads

Search leads

The /search/leads resource is used to find leads using full text search. For example, you can search for fred in texas using:

/search/leads?query=fred+tx

Search Criteria

pass in the search text using the query parameter: /search/leads?query=fred
the query parameter should be URL encoded
searching is case-insensitive: FRED and fred will both match Fred
you don’t have to enter a complete word - searching will match the beginning of words: /search/leads?query=sam will match sam and samantha
queries with multiple words like fred tx will match leads that have both fred AND tx
to specify an exact phrase (with spaces), use double quotes - "fred tx" will only match that exact text

The search results can be sorted and paginated. There are two query parameter to control sorting: sort_by and sort_dir. The sort_by parameter takes a field name (see list below) and sort_dir is ascending (asc) or descending (desc). By default, the results are sorted by relevance.

There are two query parameters to control paging: from and limit. The from parameter specifies the starting offset of that page in the search results and the limit parameter specifies how many search results to return. From is zero-based so to get the first 10 results, use from=0&limit=10, the second 10 using from=10&limit=10, etc… The maximum limit is 100 at a time, with an overall maximum of 1,000 search results.

Search Results

The search results has the total number of matching leads and an array of hits, where each hit is a matching Lead Search Result. Each lead search result contains basic information about the lead, the latest event for that lead, and highlighting of the matched text.

GET

leads

Search leads

curl --request GET \
  --url https://app.leadconduit.com/search/leads \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://app.leadconduit.com/search/leads"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://app.leadconduit.com/search/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.leadconduit.com/search/leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.leadconduit.com/search/leads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.leadconduit.com/search/leads")
  .header("Authorization", "Basic <encoded-value>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.leadconduit.com/search/leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "hits": [
    {
      "lead_id": "5fd4371e940df5a34a3888b2",
      "flow_id": "5fd4371e940df5a34a3888b2",
      "flow_name": "Sales Leads",
      "source_id": "5fd4371e940df5a34a3888b2",
      "source_name": "A Corporation",
      "first_name": "George",
      "last_name": "Washington",
      "email": "georgew@gmail.com",
      "phone_1": "5125551212",
      "phone_2": "5125552222",
      "address_1": "123 Main street",
      "city": "Austin",
      "postal_code": "78704",
      "reference": "1990118214561",
      "state": "TX",
      "submission_timestamp": "2023-11-07T05:31:56Z",
      "highlight": {},
      "latest_event": {
        "id": "5fd4371e940df5a34a3888b2",
        "reason": "<string>",
        "type": "recipient",
        "vars": {
          "price": 123,
          "purchase_price": 123,
          "event_id": "636999a5a28de89048cd16fc"
        },
        "host": "<string>",
        "start_timestamp": 123,
        "end_timestamp": 123,
        "firehose": {
          "credential_id": "5fd4371e940df5a34a3888b2",
          "enabled": true,
          "bucket": "<string>",
          "prefix": "<string>",
          "services": {
            "aws": {
              "enabled": true,
              "credential_id": "5fd4371e940df5a34a3888b2",
              "bucket": "<string>",
              "prefix": "<string>"
            },
            "azure": {
              "enabled": true,
              "credential_id": "5fd4371e940df5a34a3888b2",
              "bucket": "<string>",
              "prefix": "<string>"
            }
          }
        },
        "ms": 123,
        "wait_ms": 123,
        "overhead_ms": 123,
        "lag_ms": 123,
        "total_ms": 123,
        "handler_version": "<string>",
        "version": "<string>",
        "cap_reached": true,
        "flow_ping_limits": {
          "id": "5fd4371e940df5a34a3888b2",
          "name": "<string>",
          "maximum": 123,
          "duration": 123,
          "duration_units": "<string>",
          "time_zone": "America/New_York",
          "created_at": "2023-11-07T05:31:56Z"
        },
        "source_ping_limits": {
          "id": "5fd4371e940df5a34a3888b2",
          "name": "<string>",
          "maximum": 123,
          "duration": 123,
          "duration_units": "<string>",
          "time_zone": "America/New_York",
          "created_at": "2023-11-07T05:31:56Z"
        },
        "ping_limit_reached": true,
        "expires_at": "2023-11-07T05:31:56Z",
        "step_id": "<string>",
        "caps": [
          {
            "id": "5fd438f91f0d12766e2bfee5",
            "type": "volume",
            "name": "Monthly leads from TX",
            "maximum": 1200,
            "duration": 2,
            "rule_set": {
              "rules": [
                {
                  "lhv": "lead.state",
                  "op": "is equal to",
                  "rhv": "TX",
                  "id": "1aacd0",
                  "rule_set": "<unknown>"
                }
              ],
              "id": "0d144a"
            },
            "caps": "<array>",
            "time_zone": "America/New_York",
            "reason": "<string>",
            "created_at": "2020-11-23T11:41:52Z"
          }
        ],
        "caps_reached": true,
        "key": "<string>",
        "cost": 123,
        "purchase_price": 123,
        "sale_price": 123,
        "revenue": 123,
        "module_id": "<string>",
        "credential": {
          "id": "5fd4371e940df5a34a3888b2",
          "name": "<string>",
          "type": "user",
          "package": "<string>",
          "username": "<string>",
          "password": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z"
        },
        "credential_updated": true,
        "package_version": "<string>",
        "rule_set": {
          "rules": [
            {
              "lhv": "lead.state",
              "op": "is equal to",
              "rhv": "TX",
              "id": "1aacd0",
              "rule_set": "<unknown>"
            }
          ],
          "id": "0d144a"
        },
        "mappings": [
          {
            "property": "<string>",
            "value": "<string>",
            "id": "1aacd0",
            "rule_set": {
              "rules": [
                {
                  "lhv": "lead.state",
                  "op": "is equal to",
                  "rhv": "TX",
                  "id": "1aacd0",
                  "rule_set": "<unknown>"
                }
              ],
              "id": "0d144a"
            }
          }
        ],
        "pricing": {
          "override": true,
          "prices": [
            {
              "amount": 123,
              "id": "<unknown>",
              "rule_set": {
                "rules": [
                  {
                    "lhv": "lead.state",
                    "op": "is equal to",
                    "rhv": "TX",
                    "id": "1aacd0",
                    "rule_set": "<unknown>"
                  }
                ],
                "id": "0d144a"
              }
            }
          ]
        },
        "transactions": [
          {
            "request": {
              "method": "POST",
              "uri": "https://app.leadconduit.com/flows/5fd4371e940df5a34a3888b2/sources/6369a0e534c9d4ebe142e0ef/submit",
              "version": "1.1",
              "headers": {
                "Content-Type": "application/json",
                "Accept": "application/json"
              },
              "body": "{\"email\":\"johndoe@email.com\",\"phone_1\":\"5127891111\"}",
              "timestamp": 123
            },
            "response": {
              "version": "1.1",
              "headers": {
                "Content-Type": "application/json",
                "Accept": "application/json"
              },
              "body": "{\"outcome\":\"success\",\"lead\":{\"id\":\"63cc6f0e55254d7d1c4c3037\"}}",
              "timestamp": 123,
              "status": 201,
              "status_text": "Created"
            },
            "ms": 123
          }
        ]
      }
    }
  ],
  "total": 123
}

Authorizations

Authorization

string

header

required

LeadConduit uses HTTP Basic Authentication with the username API and your API key as the password.

For example: API:1f1b96c9150d8050e858c043d543bb4eadae0e6f'

Query Parameters

query

string

text to search for

sort_by

enum<string>

One of the following field names: lead_id, submission_timestamp, first_name, last_name, email, phone_1, phone_2, address_1, city, state, postal_code, reference

Available options:

lead_id,

submission_timestamp,

first_name,

last_name,

email,

phone_1,

phone_2,

address_1,

city,

state,

postal_code,

reference

sort_dir

enum<string>

The sort direction: "asc" or "desc", default is by relevance

Available options:

asc,

desc

from

integer

The starting offset of leads to return in the matching result set, zero-based

limit

integer

The maximum number of leads to return (maximum is 100, default is 10)

Response

200 - application/json

hits

Lead Search Result · object[]

Show child attributes

total

number

Retrieve statistics on events Get median event metrics

⌘I

API Documentation

Concepts

Search leads

Search Criteria

Search Results

Authorizations

Query Parameters

Response