curl --request GET \
--url https://www.presolve.com/api/v1/leads \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://www.presolve.com/api/v1/leads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.presolve.com/api/v1/leads"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"leads": [
{
"id": "<string>",
"caseId": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"phone": "<string>",
"zipCode": "<string>",
"city": "<string>",
"state": "<string>",
"description": "<string>",
"caseType": "<string>",
"subCaseType": "<string>",
"leadType": "<string>",
"leadStatus": "<string>",
"caseMatchStatus": "<string>",
"turnDownReason": "<string>",
"turnDownNotes": "<string>",
"pendingTurndownAt": "<string>",
"highValue": true,
"injuryDescription": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmCampaign": "<string>",
"utmCampaignId": "<string>",
"utmAdgroupId": "<string>",
"utmTerm": "<string>",
"utmContent": "<string>",
"gclid": "<string>",
"gbraid": "<string>",
"gadSource": "<string>",
"trustedFormCertUrl": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"deletedAt": "<string>"
}
],
"nextCursor": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}List / filter leads
Returns leads linked to cases owned by the selected organization. Excludes prospective intake reviews; use GET /leads/intake-reviews for those. source filters lead UTM attribution, not caseSource. nextCursor is null when the list is exhausted. These creation-ordered lists are current inventories, not change feeds: rescan to discover older records newly assigned or handed off.
Supports one selected organization via organizationId. Omit it to use the key’s organization. HQ descendant access requires an active acting attorney with hq:view_child_orgs, cases:view, cases:view_all, hq:view_all_cases. Existing key scopes still apply. The selector requires an integration API key; legacy partner/OIDC routing is unchanged. Repeat the selector on every cursor page, related mutation, upload completion, and detail/download request. See HQ authorization.
Requires the leads:read scope. Rate tier: read.
curl --request GET \
--url https://www.presolve.com/api/v1/leads \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://www.presolve.com/api/v1/leads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.presolve.com/api/v1/leads"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"leads": [
{
"id": "<string>",
"caseId": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"phone": "<string>",
"zipCode": "<string>",
"city": "<string>",
"state": "<string>",
"description": "<string>",
"caseType": "<string>",
"subCaseType": "<string>",
"leadType": "<string>",
"leadStatus": "<string>",
"caseMatchStatus": "<string>",
"turnDownReason": "<string>",
"turnDownNotes": "<string>",
"pendingTurndownAt": "<string>",
"highValue": true,
"injuryDescription": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmCampaign": "<string>",
"utmCampaignId": "<string>",
"utmAdgroupId": "<string>",
"utmTerm": "<string>",
"utmContent": "<string>",
"gclid": "<string>",
"gbraid": "<string>",
"gadSource": "<string>",
"trustedFormCertUrl": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"deletedAt": "<string>"
}
],
"nextCursor": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}{
"success": false,
"error": "<string>",
"code": "<string>"
}Authorizations
Query Parameters
new_lead, screened_needs_match, matched_to_firm_marketplace, matched_to_firm_match_direct, pending_turndown, screened_turned_down, no_contact_turned_down, PromotedToCase, hidden, ContactInProgress, under_review_with_firm, PendingLead, ContactAttemptsMaxed, DuplicateLead, financing_lead, defendant, test_lead, pending_promotion, converted, matched_to_firm_signed_retainers, waiting_for_retainer Select one organization for this request. Defaults to the key organization. An HQ key may select an active descendant when its active acting attorney has the required HQ and resource permissions. Repeat the same organizationId on related mutations, upload completion, detail requests, and every cursor page. See /authorization.