app.goodleads.club

goodleads_quote_list

What a list costs before anyone pays: pass a saved list_id (the 8-char slug) or an inline shape (states + filters), a lane (all | best | contact; contact plus a has_email filter is emailable now, plus has_phone is callable now) and an optional cap ({type: "count"|"budget", value} — records for count, cents for budget). Returns the same numbers the buy page shows a person: the graded counts (matching, sellable, verified_one, verified_both, no_channel, unnamed), facets, the live price rule (prices + price_rule_version) and — when a lane or cap is given — a quote with one line per grade. Billing discipline: only sellable records — matching records whose filing names a person — are ever billed or delivered; matching includes unnamed records with nobody to reach and is never a billable count — never present it as a price. Quote money only from this tool's numbers (name and address $0.25 per record · plus one verified phone or email $0.50 · plus both $0.70 (price rule v1; live prices always come from the summary call's `prices` block)); quote_valid_until says how long they hold. Each quote line carries `ships` (what a record at that grade ships with, in the buyer's words — a name-and-address record never ships a phone or email) and the summary carries `forecast` ({checked, phone_expected, email_expected, both_expected, basis, as_of}: how many of the records still to find on would come back with a verified phone or email, from our measured outcomes on comparable records — relay it with its basis). `ceiling_cents` is the most a buyer can be charged: today's total plus the forecast upgrades, charged only for what we find. Every record ships the owner's name and mailing address plus the business facts — the business name, entity type and status, the state filing number and formation date, the industry with its NAICS, SIC and Google Business codes, the registered agent, the Lead Reference, and the Reachability, Contact Relevance and Contact Confidence scores; open the exact f…

Page: /

Input schema

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "A saved list id (8 chars, a-z / 2-7). Pass this or states + filters, not both."
    },
    "states": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "State codes for an inline shape; omit for every live state."
    },
    "filters": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Filters follow the one GoodLeads filter contract (77 fields; GET /api/v1/schema/attributes?include=grammar): a leaf is {\"field\", \"op\", \"value\"}; the top-level list is an implicit \"and\"; {\"op\": \"and\"|\"or\", \"filters\": [...]} nests one or more children and {\"op\": \"not\", \"filters\": [one child]} negates. Operators by field type — text: eq, neq, in, not_in, contains, does_not_contain, exists, missing; number: eq, neq, gt, gte, lt, lte, between, in, not_in, exists, missing; date: eq, neq, gt, gte, lt, lte, between, in, not_in, exists, missing; boolean: eq, neq; geo: within. Sort with [{field, dir}] over any of the 71 sortable fields. Keyless callers may not filter on contact_name, email_primary, phone_primary. Live states: CO, CT, FL, NY, TX, VA. Records appear here the morning after the state posts them — speed is measured from publication, never from filing."
    },
    "include_held": {
      "type": "boolean",
      "description": "Include inactive-or-holding entities (default false)."
    },
    "lane": {
      "type": "string",
      "description": "all | best | contact — asks for a quote. For emailable now, contact with a has_email filter; for callable now, contact with has_phone."
    },
    "cap": {
      "type": "object",
      "description": "{type: \"count\"|\"budget\", value} — the dial the quote is solved against."
    }
  }
}