goodleads.club

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "A saved list id. 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 (85 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 76 sortable fields. Keyless callers may not filter on contact_name, email_primary, phone_primary. Live states: CO, CT, FL, NY, OR, TX, VA. Records appear here the morning after the state posts them — speed is measured from publication, never from filing."
    },
    "lane": {
      "type": "string",
      "description": "all | best | contact (default best)."
    },
    "cap": {
      "type": "object",
      "description": "{type: \"count\"|\"budget\", value} — records for count, cents for budget."
    },
    "delivery": {
      "type": "string",
      "description": "file (default — a CSV/Excel/JSON workbook, yours to re-download any time), crm, or connector."
    },
    "customer_email": {
      "type": "string",
      "description": "Prefills the Stripe Checkout form."
    },
    "crm_connection_id": {
      "type": "string",
      "description": "Required when delivery=crm."
    },
    "connector_crm_name": {
      "type": "string",
      "description": "Required when delivery=connector: the CRM to build for."
    },
    "price_rule_version": {
      "type": "integer",
      "description": "From goodleads_quote_list — a moved price rule then answers 409 with a fresh quote."
    },
    "expected_total_cents": {
      "type": "integer",
      "description": "The quoted total shown to the buyer (only when the quote was exact) — a moved count then answers 409."
    }
  }
}