GoodLeads

 ⟨185 unchanged words⟩ — relay it
    instead of a silent $0.

    **Values are understood, not matched literally.** Filter values are understood, not matched literally: "residential",
    "cell", "CST", "Texas", "on fire", "Denver metro" and "working from home" all resolve (case, spacing, plurals and
    reviewed words), and every response echoes what was understood in `interpreted_values` (typed → stored). A value
    that matched nothing comes back with `value_hints` — the closest real values and, for a closed list, every allowed
    value. Read both before telling a human a count is zero or a field is missing.

    **Billing discipline — read before quoting money to  ⟨733 unchanged words⟩ 

 ⟨31 unchanged words⟩  days with a phone", "NAICS 238220", "SIC 1711",
    "MCC 5812", "google category plumber") and you get
    back a list shape  ⟨84 unchanged words⟩ a masked
    field (`contact_name`, `email_primary`, `phone_primary`).

    Every classification system is an entry point — a seller who thinks in MCC,
    SIC, NAICS or Google category gets the same list. A code we do not carry
    directly WIDENS to its parent group or the industries the crosswalk ties it
    to, and `assumed` names the step; to see the other systems' equivalents for
    a code, call `explain_concept`.

    When the buyer asked a question or raised ⟨200 unchanged words⟩ 

 ⟨805 unchanged words⟩ offer code your human was given, if any.
        group_by: Up to two fields to cross-tab the summary by, e.g.
            `["property_classification", "naics_2_digit"]` — residential vs.
            commercial by industry in ONE call. Adds a `groups` block: the
            four counts and the `share` per group, the top 50 groups, the rest
            rolled into `other`. Groupable — classification: industry_sector,
            industry_name, naics_2_digit … naics_6_digit, sic_2_digit …
            sic_4_digit, gmb_category, mcc; geography: state, msa_name,
            county_fips, principal_city, principal_zip, neighborhood,
            time_zone, tract_income_band; also property_classification,
            entity_type, reachability_tier, filed_by, formation_month.
            A record not yet classified reads `Still classifying` — the
            classifier places more of them on every pipeline run, so a repeat
            call later is a better count. Inline shapes only.

    Returns:
        The summary contract described above. Keyless  ⟨10 unchanged words⟩ 

 ⟨24 unchanged words⟩ "default":null,"title":"Filters"},"group_by":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Group By"},"include_existing":{"default":false,"title":"Include ⟨60 unchanged words⟩ 

 ⟨490 unchanged words⟩ recorded as
    a request for that CRM).

    `include_existing`: the order is Just started only — brand-new businesses —
    unless you pass this (or name `filing_kind` / `business_origin` in
    `filters`); then existing businesses with a new filing are in the file too,
    labeled, and the file's Read Me says you asked for them.

    `offer_code`: the offer code your human was given ⟨117 unchanged words⟩ 

 ⟨66 unchanged words⟩ "default":null,"title":"Filters"},"include_existing":{"default":false,"title":"Include Existing","type":"boolean"},"lane":{"default":"best","title": ⟨42 unchanged words⟩ 

 ⟨25 unchanged words⟩ `fields` (default) — every one of the 8185 filterable
            fields as `{"field", "label ⟨23 unchanged words⟩ a narrower pseudo-field override), `sortable`
            flags the 7476 fields `sort` accepts, `masked` flags
            `contact_name`, `email_primary` ⟨253 unchanged words⟩  geo: within. Narrower pseudo-fields — `run_manifest_id` eq; `cluster_ref` eq; `missing_stage` eq; `created_at` gt, gte, lt, lte, between; `geo_polygon` within; `geo_radius` within; `has_phone_or_email` eq; `filing_kind` eq, neq, in, not_in; `new_business_tier` eq, neq, in, not_in. `neq`, `not_in` ⟨95 unchanged words⟩ 

 ⟨728 unchanged words⟩ include_held: Include inactive-or-holding entities (default False).
        include_existing: Include existing businesses with a new filing (a
            registration, a conversion, a reinstatement, a move, a rename) —
            the default quotes Just started only, exactly as Browse and the
            file do. Naming `filing_kind` / `business_origin` in `filters`
            widens on its own.
        lane: `all` / `best` / `contact` — asks ⟨45 unchanged words⟩ 

 ⟨24 unchanged words⟩ "default":null,"title":"Filters"},"include_existing":{"default":false,"title":"Include Existing","type":"boolean"},"include_held":{"default":false,"title":"Include ⟨52 unchanged words⟩ 

 ⟨44 unchanged words⟩ consistency (names in
    CRM-ready Title Case, not ALL-CAPSALL-CAPS; the address's own state agrees with its
    ZIP), and standardization (how much of the
     ⟨279 unchanged words⟩ 

 ⟨86 unchanged words⟩  last update, source,
        score_versions, access_level). Includes `history`: every event the state
        has published about this business, newest first, each with
        `published_date`, `event` (plain words) and `effective_date` when it
        differs; for a business that changed form, `prior_entity_ref` and
        `prior_entity_formation_date` name the record it came from. The
        `entity` carries `filing_kind` and `lead_class`. The history is free
        without a key; only the person is masked. Raises ValueError if the id 
        is not
         shaped like a Lead ID or no record matches.
    

 ⟨25 unchanged words⟩ `fields` (default) — every one of the 7781 filterable
            fields as `{"field", "label ⟨23 unchanged words⟩ a narrower pseudo-field override), `sortable`
            flags the 7174 fields `sort` accepts, `masked` flags
            `contact_name`, `email_primary` ⟨266 unchanged words⟩  lte, between; `geo_polygon` within; `geo_radius` within; `has_phone_or_email` eq.eq; `filing_kind` eq, neq, in, not_in. `neq`, `not_in`, `does_not_contain`, `not` keep rows  ⟨91 unchanged words⟩ 

 ⟨84 unchanged words⟩ ":null,"title":"List Id"},"offer_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Offer Code"},"product_id":{"anyOf":[{"type":"string ⟨24 unchanged words⟩ 

 ⟨588 unchanged words⟩  / shape, lane and
    cap to `checkout_list`.

    **Offer codes.** If your human was given an offer code — a price we agreed
    with them, like `GL-7K3Q9M` — pass it as `offer_code` here AND on
    `checkout_list`, so the quote and the payment link carry the same price.
    A code is a ceiling: every grade bills at the lower of list and the
    offer, never above list, and the reply adds an `offer` block (what is
    left on it, when it expires). A code that cannot be used answers with
    the reason in plain words — relay it, then quote again without the
    code for list price.

    Args:
        list_id: A saved list id. Mutually  ⟨52 unchanged words⟩  — the dial the quote
            is solved against.
        offer_code: The offer code your human was given, if any.

    Returns:
        The summary contract described above. Keyless  ⟨10 unchanged words⟩ 

 ⟨53 unchanged words⟩ ":null,"title":"List Id"},"offer_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Offer Code"},"states":{"anyOf":[{"items":{" ⟨14 unchanged words⟩ 

What GoodLeads is, who buys it and how every record is built — call this to explain or vet us; to price a list, start with interpret_list.

    It is for anyone who wins by reaching a business owner first: to sell what a
    new owner needs now, to be the name they already know a year from now, to
    spot their own customer starting a business, or to build a product on every
    new business. Never rule your owner out from this description — pass what
    they sell to `interpret_list` and read the free count from `quote_list`.

    Leads with what the buyer gets and how ⟨40 unchanged words⟩ 

Shelf products(starter lists)

The pre-shaped shelf — ready-made business type × state lists.lists, with live counts.

    EachReturns productthe issame alive ready-madedocument list`list_starters` ofreturns newly—
    `{"count": formedN, businesses"starters": for[...]}`, one
     entry per (state, business type in)
    with oneits statedisplay (or`label`, acrossthe everyexact live`filters` state).it Returnsopens `product_id`with, the graded
    `name`counts (`matching`, `description``sellable`, `state``verified_one`, `verified_both`) and
    `price_from_cents` (nullthe =name-and-address allgrade live— states),the `lead_count`floor, not a flat
    `price_cents`price) — plus a `note`. The shelf is the starter lists: every count here is live, `period`the price is quoted per record by `quote_list`, and `stripe_price_id`.the `period`:payment `monthly`link =comes from `checkout_list`. Every purchase is one-time; a standingbuyer orderwho billedwants eachnew period;filings absentto =keep acoming one-timesets purchase.
    `stripe_price_id`up isa Stripe'sstanding ownorder idfrom fora thatpaid priceorder's (nullreceipt, untilbilled monthly for the records actually delivered.
    catalogThere syncs)are —no informational,fixed-price neverproducts somethingand tonothing passhere back.carries Pricinga
    everywhere`product_id`: followspass thea onestarter's graded`filters` ruleto —`quote_list` for the exact
    percount recordand price, bythen whatto the`checkout_list` recordfor carriesthe (link. name +and address;address $0.25 per record · plus one verified
     phone or email;email $0.50 · plus both, verified)$0.70 —(price andrule onlyv1; live prices always come from the summary call's `prices` block).
    Only sellable records (the
     filing names a person) are ever billed. For a shape of your ownbilled, or to
    see live graded counts and 
    the exactselected pricerecords beforeare buying,frozen preferwhen the
    buying journey: `list_starters` (thelink shelfis withminted, liveso counts)what oris
    `interpret_list`billed →is `quote_list`what →is `checkout_list`.delivered. Evaluate before
     buying: `browse_leads` with 
    the same vertical/state`filters` shows real masked
     records for free. To buy a shelf product as-is, pass its `product_id`
    to `create_checkout`.
    

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"Shelf products(starter lists)"}