{"allowed_uses":{"permitted":["b2b_sales_outreach","b2b_marketing","crm_enrichment","market_research","platform_integration"],"refused":["credit_eligibility","employment_screening","insurance_underwriting","tenant_screening"]},"definitions":{"billable_base":"sellable","count_refresh":"Counts and quotes refresh once a day at 06:00 America/Denver with the overnight load; a quote holds until the next refresh.","preview_rule":"Free preview shows what the state publishes; what GoodLeads adds is for key holders.","speed":"Records appear the morning after the state posts them. Speed is measured from the state's publication, never from the date of filing.","universe":"Every list starts from 'Just started' businesses — a brand-new business with no prior filing. Widen it by filtering filing_kind (or lead_class), or pass include_existing.","universe_default_label":"Just started"},"doors":[{"for":"Clients that can add a remote MCP server","how":"Paste the address where your client asks for a remote MCP server. You need no key and no account.","id":"mcp","name":"MCP address","url":"https://mcp.goodleads.club/mcp","who":"Claude, Cursor, VS Code, Gemini Spark, Perplexity and Grok accept the address directly. ChatGPT needs one more step. A person must turn on Developer mode in the ChatGPT settings. This takes about one minute and happens one time. An agent in a chat cannot do this step."},{"for":"Any agent that can fetch a web address","how":"`GET /api/v1/counts` sizes a market. It takes states, filters as JSON, and `group_by` with up to two fields. `GET /api/v1/crosswalk?q=MCC%205812` translates an industry between code systems. You need no key. Contact details stay masked.","id":"plain_url","name":"Plain web addresses","url":"https://app.goodleads.club/api/v1/counts","who":"A ChatGPT chat without the connector, a script, a notebook, or any tool that can make a GET request."},{"for":"A person","how":"Say who you sell to. See the count and the price. Pay on a hosted page.","id":"buy_page","name":"The buy page","url":"https://app.goodleads.club/buy.html","who":"Use this way if you want a list and prefer to click, not connect or code."}],"endpoints":[{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1","summary":"Describe the API"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/answers","summary":"Answer a buyer's intent, in plain words"},{"calls_per_minute":120,"door":"v1","key_required":true,"method":"GET","path":"/v1/feedback","summary":"Your reports, newest first"},{"calls_per_minute":120,"door":"v1","key_required":true,"method":"POST","path":"/v1/feedback","summary":"Report on a record you bought"},{"calls_per_minute":120,"door":"v1","key_required":true,"method":"GET","path":"/v1/feedback/{feedback_id}","summary":"One report"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/fields","summary":"Every field you can filter on"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/jobs","summary":"Buyer jobs: why GoodLeads fits, and ready filters"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/jobs/{job_id}","summary":"One buyer job"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"POST","path":"/v1/keys","summary":"Get API keys — a test key now; the live key by a one-time email link"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/keys/challenge","summary":"A browser check for the /developers key form"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"POST","path":"/v1/keys/claim","summary":"Exchange your key link for a test key and a live key (shown once)"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/leads","summary":"Find leads"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/leads/new","summary":"New leads — today's run, the last few days, or since your last poll"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/leads/{lead_id}","summary":"Get one lead by its Lead ID"},{"calls_per_minute":120,"door":"v1","key_required":true,"method":"GET","path":"/v1/me","summary":"The key you are calling with"},{"calls_per_minute":120,"door":"v1","key_required":true,"method":"POST","path":"/v1/orders","summary":"Order a list"},{"calls_per_minute":120,"door":"v1","key_required":true,"method":"GET","path":"/v1/orders/{order_id}","summary":"Get one of your orders"},{"calls_per_minute":120,"door":"v1","key_required":true,"method":"GET","path":"/v1/orders/{order_id}/records","summary":"The records an order bought"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/pricing","summary":"Current per-record prices"},{"calls_per_minute":120,"door":"v1","key_required":true,"method":"POST","path":"/v1/quotes","summary":"Price a list"},{"calls_per_minute":30,"door":"v1","key_required":false,"method":"GET","path":"/v1/states","summary":"The states we carry, and when each last loaded"},{"calls_per_minute":null,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/manifest","summary":"This manifest: every field, limit, price, state and live feature"},{"calls_per_minute":null,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/schema/attributes","summary":"Every filterable field, with operators and allowed values"},{"calls_per_minute":null,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/schema/concepts","summary":"Map a buyer's own word to the fields we carry"},{"calls_per_minute":null,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/schema/recipes","summary":"Buyer jobs: ready filters and what each score means for that job"},{"calls_per_minute":null,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/taxonomy","summary":"The industry sectors and subsectors"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/crosswalk","summary":"One industry in NAICS, SIC, Google category and MCC"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/counts","summary":"Free counts for a filter, as one GET (optional group_by cross-tab)"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"POST","path":"/api/v1/leads/summary","summary":"Free counts, facets, prices and a quote for a filter"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"POST","path":"/api/v1/lists/interpret","summary":"Turn a buyer's words into filters"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/leads","summary":"Browse leads (owner contact masked without a key)"},{"calls_per_minute":null,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/leads/states","summary":"The live states"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/leads/field_fill","summary":"Exact fill rate of every column in the file, overall and per state"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"POST","path":"/api/v1/lists","summary":"Save a filter as a shareable list"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/lists/{list_id}","summary":"Read a saved list"},{"calls_per_minute":30,"door":"website_api","key_required":false,"method":"GET","path":"/api/v1/lists/{list_id}/summary","summary":"Counts for a saved list"},{"calls_per_minute":5,"door":"website_api","key_required":false,"method":"POST","path":"/api/v1/commerce/checkout","summary":"Open a hosted checkout for a list"}],"features":{"autonomous_agent_purchase":"live","billing_to_an_account":"coming_next","forgiving_filter_values":"live","notifications_to_your_server":"coming_next","practice_orders":"coming_next","standing_order_deliveries":"coming_next","standing_orders_from_your_code":"coming_next","standing_orders_on_the_website":"live"},"field_counts":{"export_columns":64,"free_preview_fields":50,"v1_filter_fields":49,"v1_filter_fields_with_key":52,"v1_filter_names":["business_origin","contact_confidence_tier","contact_ref","contact_relevance_tier","county_fips","email_deliverability_status","entity_is_foreign","entity_is_nonprofit","entity_is_professional","entity_is_public_benefit","entity_name","entity_type","filing_kind","formation_date","gmb_category","has_email","has_federal_tax_id","has_phone","has_phone_or_email","home_state","industry_confidence_tier","industry_name","industry_sector","lead_ref","mcc","msa_code","msa_name","naics_2_digit","naics_3_digit","naics_4_digit","naics_5_digit","naics_6_digit","neighborhood","phone_type","principal_address","principal_city","principal_zip","property_classification","reachability_tier","role_is_decision_maker","role_title","sic_2_digit","sic_3_digit","sic_4_digit","state","status","time_zone","tract_median_income","trade_name"],"v1_lead_response_fields":71,"website_api_filter_fields":86,"why_they_differ":"/v1/fields lists the fields that the public API lets you filter on. The owner's name, phone and email are never filterable. /api/v1/schema/attributes lists the full website schema. The website schema is wider. It also has fields that the public API does not filter on, and the owner contact fields (masked without a key). Where both list a field, the names, operators and values are the same."},"fields":[{"description":"Unique identifier (UUID) for the business entity record.","doors":{"export":false,"mcp":true,"preview":true,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"entity_id","label":"Entity ID","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["internal id","row id"],"type":"text"},{"description":"Persistent human-readable ID for this lead (e.g., GL-VA-04821). Assigned on first load, never changes. Use for CRM conversations, exports, and lookups.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":false,"website_api":true},"field":"lead_ref","label":"Lead Reference","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["lead id","glid","record key","permalink id","lead number"],"type":"text"},{"allowed_values":["CO","CT","FL","NY","OR","TX","VA"],"description":"Two-letter US state code where the business was formed (e.g., VA, CO, FL).","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"state","label":"State","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["filing state","formation state","registration state","state code"],"type":"text"},{"description":"Legal name of the business as filed with the Secretary of State.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"entity_name","label":"Entity Name","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["registered name","corporate name","organization name"],"type":"text"},{"description":"Market-facing DBA/trade name registered with the state — the name a customer recognizes and searches for, distinct from the legal entity name. Additional registered names are preserved on the lead detail page.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"trade_name","label":"Trade Name (DBA)","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["trading name","dba name"],"type":"text"},{"allowed_values":["LLC","PLLC","CORP","PC","LP","LLP","LLLP","NONPROFIT","COOP","PARTNERSHIP","SOLE_PROP","OTHER"],"description":"Legal structure of the business, canonicalized across states — 'LLC' matches CO 'DLLC', FL 'FLAL', NY 'DOMESTIC LIMITED LIABILITY COMPANY' alike (Tenet #3). Values: LLC, PLLC, CORP, PC, LP, LLP, LLLP, NONPROFIT, COOP, PARTNERSHIP, SOLE_PROP, OTHER (case-insensitive; legacy raw codes are resolved too). Domestic/foreign, professional, nonprofit, and public-benefit facets filter separately via entity_is_foreign / entity_is_professional / entity_is_nonprofit / entity_is_public_benefit. The raw state-specific SOS string is entity_type_raw.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"entity_type","label":"Entity Type","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["business structure","company type","entity form"],"type":"text"},{"description":"Raw state-specific entity-type string exactly as filed with the Secretary of State (CO 'DLLC', FL 'FLAL', VA 'LLC'). Provenance vocabulary — filter entity_type (canonical) unless you specifically need a state's own codes.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"entity_type_raw","label":"Entity Type (raw SOS)","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["original entity type","raw filing type","state's entity type"],"type":"text"},{"description":"True when the entity registered from out of state (a 'foreign' filing — e.g. CO 'FLLC'). Domestic formations are the new-business buying-window cohort; foreign registrations are typically established companies expanding.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"entity_is_foreign","label":"Foreign Entity","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["foreign registration","non-domestic","registered from elsewhere"],"type":"boolean"},{"allowed_values":["newly_formed","new_location","formed_out_of_state","institutional"],"description":"Why this business is on the list today: newly_formed (a formation — the Day-1 cohort), new_location (an existing business opening a location in this state), formed_out_of_state (a local owner who formed in another state and registered here to operate), institutional (a holding vehicle held at a custodian). Browse and every file default to newly_formed; the other three are sold as their own list.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"business_origin","label":"Business Origin","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["opening a location here","new location","expanding into the state","formed out of state","registration vs formation","why it is on the list"],"type":"text"},{"allowed_values":["formation","registration","conversion","name_change","reinstatement","address_change","dissolution"],"description":"What the state filing did: formation (a business that did not exist before its filing — the default, so a plain call never returns an existing business the state gave a new document number), registration (a business registered here from another state — lead_class says whether it is a local owner's new business with home-state paperwork or an existing business new to this market, the same split business_origin makes), conversion (changed legal form), name_change (a new brand), reinstatement (reactivated), address_change (moved), dissolution (closed — hidden unless named). Naming any value replaces the Just-started default (include_existing=true widens to all five existing-business kinds at once); they are their own list, never mixed into a new-business order. lead_class on every row is the same fact in the buyer's words.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"filing_kind","label":"Filing kind","masked":false,"operators":["eq","neq","in","not_in"],"sortable":false,"type":"text"},{"allowed_values":["AL","AK","AZ","AR","CA","CO","CT","DE","DC","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","PR"],"description":"The state the business was first formed in, when it is not this one — from the filing. Blank on every formation.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"home_state","label":"Home State","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["state of origin","formed in","where it was first formed","domestic state"],"type":"text"},{"description":"True when the state filing lists a federal tax ID (the number itself ships in the file as federal_tax_id). An existing business usually has one before it registers; a brand-new one rarely does.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"has_federal_tax_id","label":"Federal Tax ID on File","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["ein on file","has an ein","tax id present"],"type":"boolean"},{"description":"True for licensed-professional structures (PLLC, PC) — medical, legal, accounting and similar practices that require a professional license.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"entity_is_professional","label":"Professional Entity","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["professional entity","pllc","licensed professional entity","professional corporation"],"type":"boolean"},{"description":"True for not-for-profit entities. Most B2B buyers filter these OUT (entity_is_nonprofit=false).","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"entity_is_nonprofit","label":"Nonprofit","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["non-commercial entity","nonprofit flag"],"type":"boolean"},{"description":"True for public-benefit corporations (PBC / benefit-corp filings).","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"entity_is_public_benefit","label":"Public Benefit","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["benefit corporation","b-corp","public benefit corp","social enterprise filing"],"type":"boolean"},{"description":"Date the business was officially formed with the state. Recent formations indicate new businesses that may need services.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"formation_date","label":"Formation Date","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["start date","date of formation"],"type":"date"},{"allowed_values":["active","dissolved","withdrawn","merged","delinquent","converted","noncompliant","unknown"],"description":"Current filing status, canonicalized across states — 'active' matches FL 'A', CO 'Good Standing', TX 'In existence' alike (Tenet #3). Values: active, dissolved, withdrawn, merged, delinquent, converted, noncompliant, unknown (case-insensitive; legacy raw strings are resolved too). The raw state-specific SOS string is status_raw.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"status","label":"Status","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["filing status","standing","registration status"],"type":"text"},{"description":"Raw state-specific status string exactly as published by the Secretary of State (FL 'A', CO 'Good Standing'). Provenance vocabulary — filter status (canonical) unless you specifically need a state's own codes.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"status_raw","label":"Status (raw SOS)","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["original status","raw status","state's status wording"],"type":"text"},{"description":"When this record was first loaded into GoodLeads (ISO 8601 timestamp). The only-what's-new cohort key for delta syncs and subscriptions. Distinct from formation_date: a late-published filing is old by formation date but new by record-added time — filtering on created_at still catches it.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"created_at","label":"Record Added","masked":false,"operators":["gt","gte","lt","lte","between"],"sortable":false,"synonyms":["record added date","load date","ingested at","date added to database","first seen in dataset"],"type":"date"},{"description":"Full name of the primary contact (officer, owner, or registered agent) associated with the business.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":true,"website_api":true},"field":"contact_name","label":"Contact Name","masked":true,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["principal name","key contact","buyer name"],"type":"text"},{"description":"Persistent human-readable ID for the contact (e.g., GLC-00087). Independent of any entity — the same contact may be linked to multiple businesses.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"contact_ref","label":"Contact Reference","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["glc","contact reference number"],"type":"text"},{"description":"The primary contact's officer/agent role, canonicalized across state dialects — FL's packed code 'PSTD' and a spelled-out 'President' both read 'President, Secretary, Treasurer, Director' / 'President' (Tenet #3). Composite titles are comma-joined, so prefer `contains` ('president') over `eq` unless you want the exact composite. For 'can this person authorize a buy?' filter role_is_decision_maker instead — it answers the question directly.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"role_title","label":"Role Title","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["designation","officer designation","capacity"],"type":"text"},{"description":"True when the primary contact's filed role can bind the entity — owner, member/managing member, president/CEO, general partner, and similar (the CHOOSE signal). THE filter for 'contacts for new businesses' / 'decision-makers': it works identically across every state's title dialect. False/NULL = the filed role is clerical (secretary, registered agent) or unresolved.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"role_is_decision_maker","label":"Decision Maker","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["decision maker flag","authority flag","signing authority","owner-level role"],"type":"boolean"},{"description":"Primary email address for the contact. Sourced from skip tracing or gap-fill enrichment.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":true,"website_api":true},"field":"email_primary","label":"Email","masked":true,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["primary email","best email"],"type":"text"},{"description":"Primary phone number for the contact. Sourced from skip tracing or gap-fill enrichment.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":true,"website_api":true},"field":"phone_primary","label":"Phone","masked":true,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["primary phone","telephone","dial number"],"type":"text"},{"description":"Composite score (0-100) measuring how likely you are to reach this lead. Combines 7 signals: phone availability, email validity, contact quality, industry classification, self-representation, and more.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"reachability_score","label":"Reachability Score","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["reach score","contactability score","connectivity score"],"type":"number"},{"allowed_values":["On Fire","Very Hot","Hot","Warm","Cold"],"description":"Named tier derived from reachability score: On Fire (80-100), Very Hot (60-79), Hot (40-59), Warm (20-39), Cold (0-19). Higher tiers have stronger contact signals.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"reachability_tier","label":"Reachability Tier","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["priority tier","lead temperature","reach band","call priority"],"type":"text"},{"description":"Composite score (0-100) measuring whether the contact is the RIGHT person to sell to. Combines 7 signals: self-representation, contact source, location uniqueness, contact exclusivity, name-in-entity match, RA tier, and entity type.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"contact_relevance_score","label":"Contact Relevance Score","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["decision-maker score","relevance score"],"type":"number"},{"allowed_values":["Decision Maker","Likely Decision Maker","Probable Contact","Uncertain Contact","Unlikely Decision Maker"],"description":"Named tier from contact relevance score: Decision Maker (85-100), Likely Decision Maker (65-84), Probable Contact (45-64), Uncertain Contact (25-44), Unlikely Decision Maker (0-24).","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"contact_relevance_tier","label":"Contact Relevance Tier","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["decision-maker tier","relevance band","person-fit tier"],"type":"text"},{"description":"Composite score (0-100) measuring how confident we are this contact is a real, current, deliverable person — third dimension alongside Reachability and Contact Relevance. Combines the email deliverability verdict, cross-source name verification, and source corroboration. NULL when no enriched contact exists.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"contact_confidence_score","label":"Contact Confidence Score","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["contact quality score","realness score","person confidence score"],"type":"number"},{"allowed_values":["Verified Contact","Likely Contact","Possible Contact","Uncertain Contact"],"description":"Named tier from contact confidence score: Verified Contact (75-100), Likely Contact (50-74), Possible Contact (25-49), Uncertain Contact (5-24). Higher tiers signal data we trust enough for premium outreach.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"contact_confidence_tier","label":"Contact Confidence Tier","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["confidence band","contact quality tier"],"type":"text"},{"allowed_values":["Confirmed new","Likely new","Uncertain","Likely established","Established"],"description":"How sure we are this is a real, active business that is genuinely new — the confidence behind lead_class. Values, newest first: Confirmed new (80-100), Likely new (60-79), Uncertain (40-59), Likely established (20-39), Established (0-19). A business the state gave a new document number for an old operation (a conversion, a merger, a reinstatement) never scores above Established; a filing whose kind the state left unclear lands in Uncertain. Recomputed on every run, so a record can move down the day a structural fact appears.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"new_business_tier","label":"New business tier","masked":false,"operators":["eq","neq","in","not_in"],"sortable":false,"synonyms":["how new","newness","confirmed new","genuinely new","brand new business","new business score tier"],"type":"text"},{"allowed_values":["healthcare","legal","accounting","engineering","construction","real_estate","food_and_beverage","transportation","technology","retail","finance_and_holdings","consulting","agriculture","manufacturing","unclassified"],"description":"High-level industry classification (e.g., Technology, Real Estate, Professional Services). Derived from entity name and type using rule-based classification. Use `missing` to find unclassified records (no sector assigned) for re-running through an improved classifier.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"industry_sector","label":"Industry Sector","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["market segment","top-level industry"],"type":"text"},{"description":"Specific industry within the sector (e.g., Software Development, Property Management). More granular than sector.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"industry_name","label":"Industry","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["specific industry","sub-industry","detailed category","specialty"],"type":"text"},{"allowed_values":["confirmed","likely","possible","unknown"],"description":"How sure the classifier is about the assigned industry: confirmed / likely / possible / unknown. 'possible' = classified but weakly (a candidate to re-run as the classifier improves); 'unknown' = no sector assigned.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"industry_confidence_tier","label":"Industry Confidence Tier","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["classification confidence","industry certainty"],"type":"text"},{"description":"1987 SIC 2-digit major group (e.g. '17' = Construction Special Trade Contractors). Always populated for mapped industries — use for sector-level cohort queries.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"sic_2_digit","label":"SIC Major Group","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["sic major group","2-digit sic"],"type":"text"},{"description":"1987 SIC 3-digit industry group (e.g. '176' = Roofing/Siding/Sheet Metal). May be NULL for ambiguous mappings.","doors":{"export":false,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"sic_3_digit","label":"SIC Industry Group","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["3-digit sic","sic industry group"],"type":"text"},{"description":"1987 SIC 4-digit industry code (e.g. '1761' = Roofing, Siding, and Sheetmetal Work). The most-cited SIC depth for B2B buyers (insurance, finance, direct mail). May be NULL for ambiguous mappings (modern trades like cybersecurity, med spa).","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"sic_4_digit","label":"SIC Code","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["sic industry code","full sic code"],"type":"text"},{"description":"2017 NAICS 2-digit sector (e.g. '23' = Construction). Always populated for mapped industries.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"naics_2_digit","label":"NAICS Sector","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["naics sector","2-digit naics"],"type":"text"},{"description":"2017 NAICS 3-digit subsector (e.g. '238' = Specialty Trade Contractors). May be NULL for ambiguous mappings.","doors":{"export":false,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"naics_3_digit","label":"NAICS Subsector","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["naics subsector","3-digit naics"],"type":"text"},{"description":"2017 NAICS 4-digit industry group (e.g. '2381' = Foundation/Structure/Building Exterior). May be NULL for ambiguous mappings.","doors":{"export":false,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"naics_4_digit","label":"NAICS Industry Group","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["4-digit naics","naics industry group"],"type":"text"},{"description":"2017 NAICS 5-digit industry (e.g. '23816' = Roofing Contractors). May be NULL for ambiguous mappings.","doors":{"export":false,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"naics_5_digit","label":"NAICS Industry","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["5-digit naics","naics industry"],"type":"text"},{"description":"2017 NAICS 6-digit national industry (e.g. '238160' = Roofing Contractors). The deepest official NAICS code; most specific filter for buyer cohorts.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"naics_6_digit","label":"NAICS National Industry","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["national industry code","full naics"],"type":"text"},{"description":"The category this business would carry on its Google Business Profile / Google Maps listing. Stored as Google's stable identifier ('gcid:plumber', 'gcid:restaurant'); the display name ('Plumber', 'Restaurant') is accepted too. To see the identifier, and the NAICS / SIC / MCC that line up with it, ask explain_concept('google category plumber') or GET /api/v1/crosswalk.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"gmb_category","label":"Google Business Category","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["google business profile category","gbp category","google maps category"],"type":"text"},{"description":"The 4-digit category code payment processors use to underwrite a merchant — lets a payments seller filter to exactly the merchant types they can onboard. To find the MCC for a trade, or the NAICS / SIC / Google category for an MCC, ask explain_concept('MCC 5812') or GET /api/v1/crosswalk.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"mcc","label":"Merchant Category Code","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["mcc code","card network code","payment processor category"],"type":"text"},{"allowed_values":["owner_operator","budget_formation","midmarket_formation","premium_established","suspicious_exclude","unclassified"],"description":"Which outreach lane this business falls into, based on who filed its paperwork — founders who filed themselves answer; national-service filings are shielded.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"gtm_segment","label":"GTM Segment","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["buyer profile","outreach segment","sales segment"],"type":"text"},{"description":"What kind of registered-agent provider the business chose — from 'the owner themselves' (most reachable) up to premium national services (most shielded).","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"ra_market_tier","label":"RA Market Tier","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["filing service tier","ra tier","agent tier","agent market segment"],"type":"text"},{"description":"Whether the registered agent is a commercial service (true) vs. the business owner themselves (false). Commercial RA clients are harder to reach directly.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"ra_is_commercial","label":"RA Is Commercial","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["commercial agent","professional ra","ra service","third-party agent"],"type":"boolean"},{"description":"Whether the business owner filed as their own registered agent, suggesting a bootstrapped operation where the founder is directly reachable.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"ra_self_represented","label":"RA Self-Represented","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["own agent","owner is agent","acts as own agent"],"type":"boolean"},{"description":"Whether the registered agent is an attorney or law firm. Attorney-RA entities typically signal a sophisticated/shielded structure where the law firm filters direct outreach to the owner. SMB-focused buyers usually want to filter these OUT (ra_is_attorney=false). Surfaced by migration 026.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"ra_is_attorney","label":"RA Is Attorney","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["attorney agent","lawyer as agent"],"type":"boolean"},{"description":"Canonical display name of the registered agent on file (public record), normalized by the RA Intelligence brain. Pair with ra_is_commercial / ra_market_tier to audit one commercial RA's whole portfolio — e.g. every entity filed through one formation-service desk — to check for shared-address / shell-cluster contamination before it ships as premium inventory. Masked on preview/no-key reads the same way contact_name is (a self-represented RA name IS the owner's name).","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":true,"website_api":true},"field":"registered_agent_name","label":"Registered Agent","masked":true,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"type":"text"},{"description":"Whether a phone number was found for the primary contact through skip tracing or gap-fill enrichment.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"has_phone","label":"Has Phone","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["phone available","phone found","phone fill flag"],"type":"boolean"},{"description":"Whether an email address was found for the primary contact through skip tracing or gap-fill enrichment.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"has_email","label":"Has Email","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["email available","email found","email fill flag"],"type":"boolean"},{"description":"Whether the primary contact has either a phone number or an email — the broadest sellable contact set (union of has_phone and has_email). Synthesized at query time from has_phone OR has_email; not stored on lead_browse.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":true,"v1_filter_with_key":true,"v1_response":false,"website_api":true},"field":"has_phone_or_email","label":"Has Phone or Email","masked":false,"operators":["eq"],"sortable":false,"synonyms":["any channel","either channel present"],"type":"boolean"},{"allowed_values":["abuse","catch-all","do_not_mail","invalid","spamtrap","unknown","valid"],"description":"Whether the email is safe to send to: 'valid' passed live verification; 'catch-all' means the domain accepts all mail (unproven mailbox); 'unknown' means unverified.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"zb_email_status","label":"Email Status","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["email validation status","bounce risk","send safety","deliverability verdict"],"type":"text","v1_name":"email_deliverability_status"},{"description":"How many times we have run the first owner phone-and-email lookup on this record, counting every attempt (match, no match, or a failed lookup) — not just successful ones. 0 = never attempted. Filter skip_trace_attempts = 0 to find records that haven't been through skip trace yet; skip_trace_attempts < 2 to exclude records already tried twice with no result.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"skip_trace_attempts","label":"Skip Trace Attempts","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"type":"number"},{"description":"How many times we have run the second, gap-filling phone-and-email lookup on this record, counting every attempt (match, no match, or a failed lookup) — not just successful ones. 0 = never attempted. Filter gapfill_attempts = 0 to find records that haven't been gap-filled yet; gapfill_attempts < 2 to exclude records already tried twice with no result — e.g. `has_email = false AND gapfill_attempts < 2 AND skip_trace_attempts < 2` targets records genuinely worth another enrichment dip, not likely-dead ones.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"gapfill_attempts","label":"Gap-fill Attempts","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"type":"number"},{"allowed_values":["landline","mobile","unknown","voip"],"description":"Type of phone number: mobile (best for SMS/calls), landline, voip. Mobile numbers have highest outreach success.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"phone_type","label":"Phone Type","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["mobile or landline","phone kind","number type"],"type":"text"},{"allowed_values":["RESIDENTIAL","COMMERCIAL","INDUSTRIAL","AGRICULTURAL","EXEMPT","VACANT","UNKNOWN"],"description":"Type of property at the business address: RESIDENTIAL, COMMERCIAL, INDUSTRIAL, AGRICULTURAL, EXEMPT, VACANT, UNKNOWN. Residential addresses with a single entity suggest an owner-operator.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"property_classification","label":"Property Classification","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["property type","real estate type","residential or commercial","land use"],"type":"text"},{"description":"Whether the business address is on vacant land. Vacant land entities may be shell companies or land holdings.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"property_is_vacant","label":"Property Is Vacant","masked":false,"operators":["eq","neq"],"sortable":true,"synonyms":["vacant land","empty lot","undeveloped parcel"],"type":"boolean"},{"description":"Assessed/appraised value of the property in dollars. Higher values may indicate established businesses.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"property_assessed_value","label":"Property Assessed Value","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["assessed value","property value","home value","real estate value"],"type":"number"},{"description":"Principal business address from the SOS filing. May be a home address for self-represented businesses.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"principal_address","label":"Address","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["main address","primary address"],"type":"text"},{"description":"Federal county FIPS code from geocoding. Useful for geographic targeting and market analysis.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"county_fips","label":"County FIPS","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["county code","fips code","county identifier"],"type":"text"},{"description":"City from the principal business address, canonicalized by the address normalization brain to one customer-visible spelling per city (USPS primary city for the record's ZIP, Title Case — 'Fort Lauderdale', not 'FT. LAUDERDALE'). Filters are case- and spelling-variant tolerant: 'ft lauderdale' matches 'Fort Lauderdale'.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"principal_city","label":"City","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["municipality","business city"],"type":"text"},{"description":"5-digit ZIP code from the principal business address.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"principal_zip","label":"ZIP","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["five-digit zip","postal code of record"],"type":"text"},{"allowed_values":["Mailing Address","Officer of Record","Organizer of Record","Registered Agent (Self)","State Filing"],"description":"Where we verified and reached the owner: 'State Filing' (the principal address on the filing — the default), 'Officer of Record', 'Organizer of Record' (New York — the person who filed the Articles), 'Mailing Address', or 'Registered Agent (Self)'. Anything other than State Filing means we worked a better address from the same filing, chosen when the filing principal is a mail drop or formation suite. Browse displays that working address; every file and CRM push prints the filing address in principal_address and the working address beside it in working_address. The record's `state` is always the formation state.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"address_source","label":"Address Source","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["address provenance","which address we display","working address origin","address origin"],"type":"text"},{"description":"Named neighborhood or unincorporated community the business address sits in (e.g. 'Capitol Hill', 'South Austin', 'Kendall') — the most specific public-gazetteer polygon containing the geocoded point: a Who's On First neighbourhood first, else a Census Designated Place. Finer than city, so pair it with state (and usually city or MSA). Null outside every named polygon or where the gazetteer is not loaded. GET /api/v1/schema/geo-words?state=XX lists every word and alias a state resolves.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"neighborhood","label":"Neighborhood","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["neighbourhood","district","part of town","side of town","community","area of the city","barrio"],"type":"text"},{"description":"Time zone of the business address, as an IANA zone name — 'America/New_York', 'America/Chicago', 'America/Denver', 'America/Los_Angeles', 'America/Phoenix'. Use it to call inside local business hours and to schedule a send. It is a NAME, not a fixed offset, because the offset depends on the date: America/New_York is UTC-5 in January and UTC-4 in July, and America/Phoenix never changes. Dialers, CRMs and schedulers take the name directly. Taken from the address (the statutory boundaries in 49 CFR Part 71), never from the area code — number portability means a phone's area code no longer says where anyone is. States split: Florida's panhandle is Central while Miami is Eastern, and El Paso is Mountain while the rest of Texas is Central. Null when the record has no coordinates.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"time_zone","label":"Time Zone","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"type":"text"},{"description":"Standard government code for the metro area (e.g. Tampa metro) — use msa_name if you just want the metro's name.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"msa_code","label":"MSA Code (CBSA)","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["cbsa code","metro code"],"type":"text"},{"description":"Canonical Metropolitan Statistical Area name (e.g. 'Tampa-St. Petersburg-Clearwater, FL'). Multi-select for territory sellers covering adjacent metros. Reflects where the business address sits, not the state it filed in — a company filed in New York with a Miami address counts under Miami, so metros outside our live states appear here without meaning we cover that state's filings.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"msa_name","label":"MSA","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["metro name","city region"],"type":"text"},{"allowed_values":["Under $50K","$50K-$75K","$75K-$100K","$100K-$150K","$150K+"],"description":"Income band of the NEIGHBORHOOD around the business address — the census tract's median household income per the US Census Bureau's American Community Survey, banded: 'Under $50K', '$50K-$75K', '$75K-$100K', '$100K-$150K', '$150K+'. A days-old filing address is usually the owner's home, so this reads as the founder's neighborhood affluence — an area statistic for prioritization and offer-fit, never the contact's personal income.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":false,"v1_filter_with_key":false,"v1_response":true,"website_api":true},"field":"tract_income_band","label":"Neighborhood Income","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["income band","household income","neighborhood income","affluence","buying power","wealth band"],"type":"text"},{"description":"The raw median household income (dollars) of the census tract around the business address, from the US Census Bureau's ACS 5-year estimates. Numeric sibling of Neighborhood Income for range filters (e.g. gte 120000). An area statistic, not the contact's income.","doors":{"export":true,"mcp":true,"preview":true,"v1_filter":true,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"tract_median_income","label":"Neighborhood Median Income","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["median income","median household income","area income","census income"],"type":"number"},{"description":"First 3 digits of phone_primary — useful for territory-by-area-code targeting. Auto-syncs with the phone column (Postgres generated column).","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"area_code","label":"Phone Area Code","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["phone prefix","npa","dialing code","phone area"],"type":"text"},{"allowed_values":["Match","No_Match","Tie"],"description":"Result of US Census geocoding: Match, No_Match, Tie. Match means the address was successfully geolocated.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"geocode_status","label":"Geocode Status","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["geocoding result","address match status","geolocation status"],"type":"text"},{"description":"ID of one processing run on our side — use it to retrieve exactly the records that run produced.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"run_manifest_id","label":"Pipeline Run","masked":false,"operators":["eq"],"sortable":false,"synonyms":["run id","cohort id","pipeline run id","processing run"],"type":"text"},{"description":"Every business with the same owner (ADR-060): the group's reference (GLX-…) as stamped on each member. The record page's 'N businesses' link opens this cohort.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"cluster_ref","label":"Same owner","masked":false,"operators":["eq"],"sortable":false,"synonyms":["same owner","owner group","same-owner group","one owner"],"type":"text"},{"description":"Records a pipeline brain has never processed — the value is a stage key (e.g. 'ra', 'classify', 'geocode'). These are the stage-coverage gaps the Data Quality scorecard counts; the same filter scopes a repair run on the pipeline trigger, so a gap cohort is one click from browse to fix.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"missing_stage","label":"Missing pipeline stage","masked":false,"operators":["eq"],"sortable":false,"synonyms":["coverage gap","never processed","unstamped records","stage never ran","unprocessed by brain"],"type":"text"},{"allowed_values":["name_and_address","address_only","mailing_fallback","name_with_state","operating_business","hold"],"description":"How the platform decided to hunt for this record's contact info — or 'hold' when the entity looks non-operating and isn't worth spending on.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"enrichment_strategy","label":"Sellability strategy","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["routing decision","enrichment plan","lookup strategy","trace mode"],"type":"text"},{"description":"How many of our records carry this same person-name — high counts mean a professional filer's name, not a real owner.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"name_density","label":"Name density","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["shared-name count","same-name entities in corpus","name frequency in corpus"],"type":"number"},{"allowed_values":["very_common","common","uncommon","rare"],"description":"How rare the contact's last name is in the US population — rare names make identity matches much more certain.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"name_rarity","label":"Name rarity","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["surname rarity","rare last name","how common is the last name in the us"],"type":"text"},{"description":"How many businesses are registered at this exact spot — one means a real unique address; dozens mean a mail drop or filing-mill suite.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"address_density","label":"Address density","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["same-address count","shared address count","address crowding","entities at this address"],"type":"number"},{"allowed_values":["operating_business","mail_drop_or_formation_suite","asset_protection_holding","mass_filing","single_asset_property_llc"],"description":"Whether this is a real operating business worth calling — versus a mail-drop registration, an asset-protection shell, or a property-holding LLC.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"entity_archetype","label":"Entity archetype","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["business kind","operating vs holding","entity category"],"type":"text"},{"description":"How many businesses share this owner, counting this one. 2 or more means the same person filed more than one business, so one call reaches the set — a portfolio owner filing three LLCs this month is one relationship, not three cold calls. Blank for a business with no related filing, so a numeric filter never matches those.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"cluster_size","label":"Owner group size","masked":false,"operators":["eq","neq","gt","gte","lt","lte","between","in","not_in","exists","missing"],"sortable":true,"synonyms":["businesses under one owner","portfolio owner","serial founder","related filings","filed more than one"],"type":"number"},{"allowed_values":["XF-O","XF-V","XP-O","XP-V","XV-V","XM-O","XM-V"],"description":"This record's place among the businesses under one owner, as a type and a role. The type: XF one operating business plus the holding companies built around it; XP several operating businesses under one owner; XV a structure (holding companies only, a deal being formed); XM the same across states. The role: O an operating business, V a holding company (a property LLC, a GP / LP). Filter the O roles to call the business the owner runs; the V roles name the operating business they serve in cluster_operating_name. Blank for a business with no related filing.","doors":{"export":true,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":true,"v1_response":true,"website_api":true},"field":"cluster_code","label":"Owner group role","masked":false,"operators":["eq","neq","in","not_in","contains","does_not_contain","exists","missing"],"sortable":true,"synonyms":["owner group role","holding company or operating business","portfolio role","group type"],"type":"text"},{"description":"Territory boundary — matches leads whose geocoded location falls inside a polygon. Value is a ring of [longitude, latitude] vertex pairs, e.g. [[-80.3, 25.7], [-80.1, 25.7], [-80.1, 25.9], [-80.3, 25.9]] (auto-closed, max 500 vertices). Drawn on the Map View's territory tool; works on browse, geo, export, and pipeline scoping like any other filter. Leads without coordinates never match.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"geo_polygon","label":"Map area","masked":false,"operators":["within"],"sortable":false,"synonyms":["territory boundary","map area","draw-to-select region","custom territory","polygon filter"],"type":"geo"},{"description":"Radius territory — matches leads whose geocoded location is within N miles of a center. Value is an object: {\"zip\": \"80013\", \"miles\": 15} (the ZIP's Census ZCTA centroid), {\"city\": \"Aurora\", \"state\": \"CO\", \"miles\": 15} (the mean of the city's ZIP centroids), or {\"lat\": 39.66, \"lon\": -104.77, \"miles\": 15}. Miles > 0 and <= 300. Works on browse, summary, geo, export, and pipeline scoping like any other filter. Leads without coordinates never match.","doors":{"export":false,"mcp":true,"preview":false,"v1_filter":false,"v1_filter_with_key":false,"v1_response":false,"website_api":true},"field":"geo_radius","label":"Within miles of","masked":false,"operators":["within"],"sortable":false,"synonyms":["within miles of","mile radius","near a zip","around a city","radius filter","service area radius"],"type":"geo"}],"generated_from":"tools/build_capability_manifest.py — never edit by hand; run --write","glossary":{"Contact":"The person who can authorize a purchase for that business.","Entity":"A business pulled from a Secretary of State filing.","Lead":"A business plus its owner, scores and attributes. The unit you buy.","Lead ID":"A permanent reference like GL-CO-00042 (GL-<STATE>-<number>); the lead_ref field. It never changes.","matching":"Every record that fits your filter, named owner or not. Counts show it; you are never billed on it.","sellable":"A matching record whose filing names a person. Only sellable records are ever billed or delivered."},"limits":{"checkout_calls_per_minute":5,"first_party_calls_per_minute":{"no_key":30},"first_party_page_size_max_no_key":25,"rate_limit_response":"HTTP 429 with a Retry-After header (seconds to wait)","summary_timeout_seconds":8,"v1_calls_per_minute":{"live_key":120,"no_key":30,"test_key":60},"v1_failed_key_attempts_per_minute":20,"v1_filter":{"max_chars":4000,"max_depth":4,"max_leaves":25},"v1_page_size":{"default":25,"max":100,"max_no_key":25},"v1_read_timeout_seconds":10},"manifest_schema":"2026-10.1","mcp_tools":["browse_leads","checkout_list","create_checkout","data_quality_scorecard","describe_surface","explain_concept","field_fill_rates","find_lead_by_glid","interpret_list","list_filterable_fields","list_live_states","list_products","list_starters","quote_list"],"partner":{"contact":"hello@goodleads.club","declared_use":"platform_integration","terms_gist":"API access is for your own internal use. Do not resell or proxy API responses. Do not build a competing client. Do not exceed the rate limits.","terms_section":"§10 API terms","terms_url":"https://goodleads.club/terms.html"},"prices":{"both_cents":70,"currency":"USD","line":"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)","live_source":"GET /v1/pricing (always current)","name_address_cents":25,"offer_code":null,"one_channel_cents":50,"price_rule_version":1},"states":[{"code":"CO","name":"Colorado"},{"code":"CT","name":"Connecticut"},{"code":"FL","name":"Florida"},{"code":"NY","name":"New York"},{"code":"OR","name":"Oregon"},{"code":"TX","name":"Texas"},{"code":"VA","name":"Virginia"}],"territory":{"code_systems":["NAICS","SIC","Google category","MCC"],"geography":["metro","county","city","ZIP","neighborhood","time zone","tract income"],"group_by_max_fields":2}}