How to read this
Built for four readers at once.
Most data dictionaries serve one audience — usually a marketer skimming for value. This one serves four. The buyer evaluating fit, the data engineer scoping ingestion, the compliance reviewer sizing license risk, and the end-user piloting integration with a sample record in hand. Every section answers all four.
License classification, per field.
Every value carries one of three license tiers — at the field level, not the record level. Some fields stack both (a derivation built on top of an enriched source). Your compliance team can reason about residency, sharing, and resale on every cell.
Public Record
Sourced directly from Secretary of State filings and federal public data. No resale restrictions.
Enriched
Third-party-provider-licensed. Skip-trace, validation, and parcel data. Resale subject to your master agreement.
Derived
GoodLeads proprietary. Scores, classifications, and intelligence we compute. Licensed under your contract.
EnrichedDerived
Stacked. A derivation built on an enriched input. The parent license flows through — both apply.
Coverage vocabulary.
"Always" is ambiguous. We use a controlled set of four values so you can size your population for any field at a glance. All measured percentages are anchored to the sellable cohort (operating businesses worth selling) — not the full pulled set.
Always present
100% non-null on every record. You can rely on this column existing in every row.
State-dependent
Present only when the source state files it. We document which states for each field.
Vendor-conditional
Present when the enrichment channel returned a value. Otherwise null.
NN%
Measured fill rate on the sellable cohort. Refreshed monthly from production.
Measure your results.
Every row is one business paired with one contact. Use the row key and the cohort columns below to see which records turned into customers, then tell us what happened.
Row key
lead_ref + contact_ref together identify a row. One row is one business and one contact, so lead_ref repeats when a business has two contacts.
Cohort columns
Cut your results by
state, formation_date, filed_date, lead_class, new_business_tier, reachability_tier, contact_relevance_tier, pulled_date, verified_date, days_filing_to_delivery. The delivery dates tell you how fresh each record was when it reached you.
Join keys
lead_ref (your CRM, one business); contact_ref (your CRM, one person); state_entity_id (the state's own registry, together with state); county_fips (county-level data); msa_code (metro-area data); principal_zip (ZIP-level data).
Send outcomes back
Email hello@goodleads.club with the
lead_ref and what happened (reached, booked, bought, wrong person). We use it to tune what we send you next.
Generated 2026-10-21 from the delivered-file layout 7cca0d2c · 101 columns · Data Dictionary v2.3
Your file matches what you bought.
Every file carries its own Data Dictionary tab listing exactly the columns in that file, nothing more. The full file carries all 101 columns on this page. The email file is cut for sending.
The email file
79 columns, including
delivery_number and delivery_date. Every record carries a person and an email, with its deliverability status and the free-mailbox flag, plus the two scores that tell you who to write to first. It carries no phone columns.
Left out of the email file
entity_is_foreign, business_origin, home_state, has_federal_tax_id, federal_tax_id, federal_tax_id_status, filing_kind, new_business_reason, prior_entity_ref, prior_entity_formation_date, verified_date, registered_agent_name, registered_agent_market_tier, registered_agent_segment, registered_agent_is_commercial, registered_agent_is_owner, registered_agent_is_attorney, phone_primary, phone_type, area_code, phone_2, has_phone.
Confidence on every derivation.
No value ships without a signal telling you how much to trust it. Three patterns recur throughout.
Pattern 01
Numeric scores
0–100, reported with raw score plus named tier — Reachability 73 → "Very Hot."
Pattern 02
Confidence tiers
confirmed · likely · possible · unknown — used for classifications.
Pattern 03
Match status
MATCHED · NEAREST · NO_MATCH — used for spatial and identity joins.
What you'll see in source attribution.
We've curated a supply chain you don't have to think about. Sources are described by role, not by brand — so your team isn't tempted to go around us, and so we can swap providers when one underperforms. The four roles you'll see:
SOS filing
The state's own record. We pull within days of public availability.
Public federal data
US Census Bureau (geocoding, county FIPS, census tract).
Curated enrichment channel
Skip-trace, gap-fill, email validation, parcel data. Provider relationships managed by GoodLeads.
GoodLeads proprietary
Our classifiers, scorers, and intelligence engines.
No matches
Nothing here. Try a different search.
Section 01 · Part I
Identifiers
The persistent keys you use to track a lead through your CRM, your campaigns, and your sales conversations. Two are ours, two are the state's. Ours stay stable across re-enrichment cycles; the state's stays stable for original-record lookup.
| Identifier | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| lead_refLead Reference | Text | Persistent GoodLeads ID for this record (for example GL-VA-04821). Include it in any question, feedback flag, or CRM note — it identifies the record forever. | GoodLeads proprietary | Derived | Always present | Name any business in a CRM note, a question to us or a feedback flag; the reference identifies the record forever. |
| stateState | Enum | Two-letter US state where the business filed. Values: CO, CT, FL, NY, OR, TX, VA. |
SOS filing | Public | Always present | Compare results by state; every row carries the two-letter code of the state where the business filed. |
| state_entity_idState Filing Number | Text | The state's own filing number for this business — look it up directly on the state registry. | SOS filing | Public | Always present | Look the business up on the state's own registry, or answer a compliance reviewer who asks where a record came from. |
| contact_refContact Reference | Text | Persistent GoodLeads ID for the contact (for example GLC-00087) — the same person may appear on several businesses. | GoodLeads proprietary | Derived | Always present | Recognise the same person across several businesses and call them once. |
Section 02 · Part I
Business Profile
The core firmographic record — what every B2B data product ships. The difference: we normalize 50 different state formats to one canonical schema, so your CRM ingests one shape no matter how many states you turn on.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| entity_nameEntity Name | Text | Legal name of the business as filed with the state. | SOS filing | Public | Always present | Open your outreach with the business's legal name, or search your CRM for it before you call. |
| trade_nameTrade Name (DBA) | Text | Market-facing DBA/trade name registered with the state — the name a customer recognizes, distinct from the legal entity name. Blank when the business operates under its legal name. | SOS filing | Public | Present when a DBA is registered | Use the name customers recognise in your opening line when it differs from the legal name. |
| entity_typeEntity Type | Enum | Legal structure of the business — standardized across states (LLC, CORP, LP, LLP, NONPROFIT, etc.). Values: COOP, CORP, LLC, LLLP, LLP, LP, NONPROFIT, OTHER, PARTNERSHIP, PC, PLLC, SOLE_PROP. |
SOS filing | Public | Always present | Qualify by structure (an LLC and a corporation buy differently) and change your pitch language to match. |
| entity_is_foreignForeign Entity | Boolean | True when the business registered from out of state (a foreign filing). | SOS filing | Public | Always present | Remove out-of-state registrations from a first-purchase campaign, or keep only them to work the businesses opening a location here. |
| business_originBusiness Origin | Enum | Why this business is on the list: Newly formed in <state> (a brand-new business); New location of an existing business (registered here from an out-of-state address); New business, formed out of state (a local address, formed in another state); Holding or institutional vehicle (held at a custodian). A file sold as newly formed carries only the first; the others ship as their own list. Values: Holding or institutional vehicle, New business, formed out of state, New location of an existing business, Newly formed in Colorado, Newly formed in Connecticut, Newly formed in Florida, Newly formed in New York, Newly formed in Oregon, Newly formed in Texas, Newly formed in Virginia. |
SOS filing | Public | Stamped on every record the entity_name stage has touched; blank rows count as newly formed until re-stamped | Split your list by why the business is on it: brand new, a new location of an existing business, or formed out of state. |
| home_stateHome State | Text | The state the business was first formed in, when it is not this one — from the filing. Blank on every newly formed business. | SOS filing | Public | Registrations whose filing names a home state | Segment the businesses opening a location here by where they come from. |
| has_federal_tax_idFederal Tax ID on File | Boolean | True when the state filing lists a federal tax ID — the number itself is in Federal Tax ID (EIN). An existing business usually has one before it registers; a brand-new one rarely does. Blank where the state's feed has no such field. | SOS filing | Public | Florida (the one feed with the field); blank elsewhere | Separate businesses that already have a federal tax ID, which are further along, from those that do not. |
| federal_tax_idFederal Tax ID (EIN) | Text | The business's federal tax ID (EIN) as the state filing lists it, in the form 12-3456789. Blank when the filing lists none — a brand-new business often files before it has one — or when the state's feed carries no such field (Florida is the state that publishes it). | SOS filing | Public | Florida (the one feed with the field), on filings that list a number; blank elsewhere. In the file, not a Browse filter. | Match a record to your own customer, vendor or onboarding files on the tax ID instead of the business name. |
| federal_tax_id_statusFederal tax ID status | Enum | Where the business stood on its federal tax ID (EIN) when it filed: Applied for (the owner has asked the IRS for one and it has not arrived — the clearest sign of a brand-new business), Assigned (the filing lists a number), Not applicable, or Not listed (the filing left it blank). Blank outside Florida, the state that publishes it. Values: Applied for, Assigned, Not applicable, Not listed. |
SOS filing | Public | Florida (the one feed with the field); blank elsewhere. In the file, not a Browse filter. | Lead with Applied for when you sell a first bank account, payroll or payments: the owner is setting up right now. |
| filing_kindFiling kind | Enum | What the state filing did: a brand-new business, an existing business registering in this state, a change of legal form, a new name, a reactivation, a move, or a closing. A file sold as new businesses carries only formations; the others ship as their own list. Values: address_change, conversion, dissolution, formation, name_change, registration, reinstatement. |
State events feed + SOS filing | Public | Every record; a record with no published event is a formation | Choose which filings you work: new businesses only, or the changes (a new name, a move, a reactivation) that are reasons to call. |
| lead_classLead class | Enum | The same fact in the words you sell by — so a rep knows in one glance whether this is a first purchase (Just started — including a local owner who formed in another state, home-state paperwork) or a reason to call an operating business (New to <state>, the record's own state; Established business, new entity; New trade name; Back in business; Moved). Values: Back in business, Established business, new entity, Just started, Moved, New to Colorado, New to Connecticut, New to Florida, New to New York, New to Oregon, New to Texas, New to Virginia, New trade name. |
Derived from filing_kind + business_origin | Public | Every record | Tell a rep in one glance whether this is a first purchase or a reason to call an operating business. |
| new_business_tierNew business tier | Enum | How sure we are this is a real, active, newly formed business: Confirmed new, Likely new, Uncertain, Likely established, or Established. Blank on a record not yet scored. Values: Confirmed new, Established, Likely established, Likely new, Uncertain. |
GoodLeads proprietary | Derived | Every scored record | Work Confirmed new and Likely new first when your offer is a first purchase. |
| new_business_reasonNew business reason | Text | Why we placed the business in that tier, in one short line built from facts on the filing (for example: First-ever filing for this business · no earlier filings on record · hasn't applied for a tax ID yet). | GoodLeads proprietary | Derived | Every scored record | Read the one-line reason behind the tier to give a rep an opener, and to check the call against the filing. |
| last_eventLast event | Text | The most recent thing the state published about this business, in plain words. | State events feed | Public | Every record ("Formed" when nothing has been published since) | Open a trigger campaign with what the state last published about the business, in the owner's own terms. |
| last_event_dateLast event date | Date | The day the state published that event — the day your clock starts. | State events feed | Public | Every record (the formation date when nothing has been published since) | Sort by this date to work the freshest trigger first. |
| prior_entity_refPrior record | Text | For a business that changed form, the record it came from: its Lead ID when we hold it, otherwise the state's document number. | State events feed | Public | Records that changed form | Open the earlier record of a business that changed form to see the history behind its new filing number. |
| prior_entity_formation_datePrior record formed | Date | When that prior business was first formed — how long this owner has been operating. | State events feed | Public | Records that changed form; blank on a new-to-market record (the state does not publish the home-state date) | Judge how long the owner has been operating before you decide what to offer. |
| entity_is_professionalProfessional Entity | Boolean | True for a licensed-professional entity (PLLC / PC). | SOS filing | Public | Always present | Isolate licensed practices (medical, legal, accounting) for a vertical-specific campaign. |
| entity_is_nonprofitNonprofit | Boolean | True for a not-for-profit entity. | SOS filing | Public | Always present | Exclude nonprofits from a for-profit campaign, or keep only them for a nonprofit offer. |
| entity_is_public_benefitPublic Benefit | Boolean | True for a public-benefit corporation (B-corp filing). | SOS filing | Public | Always present | Find benefit-corporation filings for mission-led or impact-focused outreach. |
| statusStatus | Enum | Current filing status — standardized across states (active, dissolved, withdrawn, etc.). Values: active, converted, delinquent, dissolved, merged, noncompliant, unknown, withdrawn. |
SOS filing | Public | Always present | Keep only active businesses in a sales campaign, or work the dissolved ones for a closing-services offer. |
| formation_dateFormation Date | Date | Date the business was officially formed with the state. | SOS filing | Public | Always present | Count days since formation to time your outreach inside the first weeks of the business. |
| filed_dateFiled Date | Date | Date the filing appears in the state registry — the start of the freshness clock. Matches formation_date. | SOS filing | Public | Always present | Start your freshness clock from the day the filing appears in the state registry. |
| published_datePublished by state | Date | The day the filing appeared on the state's public record. Freshness is measured from here, never from the filing date. | State events feed + SOS filing | Public | Every record | Measure how fast you reach a business from the day the state made it public. |
| pulled_datePulled Date | Date | Date GoodLeads pulled this filing from the state registry. | GoodLeads proprietary | Derived | Always present | Confirm which day we collected the filing, to reconcile a delivery against your own records. |
| verified_dateVerified Date | Date | Most recent date the contact channels on this record were verified. Blank when no verification pass is recorded. | GoodLeads proprietary | Derived | Present when a verification pass is recorded | Check how recently we verified the phone and email channels before you plan a campaign around them. |
| days_filing_to_deliveryDays: Filing to Delivery | Number | Days between the state filing (filed_date) and the moment this file was generated. The freshness of every record, printed on every record. | GoodLeads proprietary | Derived | Always present | Report how fresh the file was on arrival, and prioritise the youngest filings. |
| delivery_numberDelivery Number | Number | Which delivery of your subscription this record arrived in: 1 for the first file, 2 for the next, and so on. Filter on it to look at one week's records. Only on standing-delivery files. | GoodLeads proprietary | Derived | Always present in recurring deliveries | Compare results from one delivery to the next, and tell us which delivery a record arrived in. |
| delivery_dateDelivery Date | Date | The date of the delivery this record arrived in (YYYY-MM-DD). Only on standing-delivery files. | GoodLeads proprietary | Derived | Always present in recurring deliveries | Group your results by the week each record reached you. |
| owner_group_codeOwner group role | Enum | 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). Blank for a business with no related filing. Every owner group has one owner; call the owner once and you reach the set. Values: XF-O, XF-V, XM-O, XM-V, XP-O, XP-V, XV-V. |
Derived (Linkage) | Public | Records with a related filing in the book | Tell a portfolio owner's operating business from the holding companies built around it. |
| owner_group_sizeOwner group size | Number | How many businesses share this owner, counting this one (Same owner · 3 businesses). Blank for a business with no related filing. | Derived (Linkage) | Public | Records with a related filing in the book | Call a many-business owner once instead of three separate times. |
| owner_group_owner_nameOwner | Text | The owner every business in this group shares — the one person to call. Blank for a business with no related filing. | Derived (Linkage) | Public | Every member of an owner group | Ask for the one owner who reaches every business in the group. |
| owner_group_operating_business_nameOperating business | Text | On a holding company (role V): the operating business it was built around — the one the owner runs. Blank on an operating business or a business with no related filing. | Derived (Linkage) | Public | Holding companies in an owner group | Route a holding company's call to the business the owner actually runs. |
Section 03 · Part I
Location & Geography
The state gives you a string. We give you a parsed, geocoded, census-attributed, MSA-tagged, area-code-derived location. Same record. Five additional layers of geographic context.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| principal_addressAddress | Text | Principal business address exactly as filed with the state — always the filing address, on every file. Often a home address for brand-new businesses. | SOS filing | Public | Always present | Mail to, or look up, the address exactly as the business filed it; for a new business it is often the owner's home. |
| principal_cityCity | Text | City from the principal business address. | SOS filing | Public | Always present | Target and route by city. |
| principal_zipZIP | Text | 5-digit ZIP code from the principal business address. | SOS filing | Public | Always present | Target by ZIP, or roll records up to your own delivery or service areas. |
| address_stateAddress State | Text | Two-letter state of the principal address. Usually matches State — a business can file in one state and list a principal address in another, and the address prints its own state. State stays the state where the business filed. | SOS filing | Derived | Always present | Fill the state field in your CRM address block with the state of the address itself, which can differ from the filing state. |
| address_sourceAddress Source | Enum | Where we verified and reached the owner: State Filing means at the principal address on this row (the default); Officer of Record, Organizer of Record (New York — the person who filed the Articles), Mailing Address, and Registered Agent (Self) mean we worked a better address from the same filing, printed in working_address. The principal address on the row is always the filing address. Values: Mailing Address, Officer of Record, Organizer of Record, Registered Agent (Self), State Filing. |
GoodLeads proprietary | Derived | Always present | See where we reached the owner, and audit any address that is not the one on the filing. |
| working_addressWorking Address | Text | The address we verified and reached the owner at when it is not the filing address — an officer's own address, the mailing address, or a self-represented owner's registered-agent address from the same filing, as one line with its own state. Blank when we worked the filing address (Address Source = State Filing). | GoodLeads proprietary | Derived | Working-address records | Send mail to the address where we reached the owner when it differs from the filing address. |
| countryCountry | Text | Country of the business address. Always US — every record comes from a US state filing. Included so the file maps onto CRM address fields without edits. | GoodLeads proprietary | Derived | Always present | Map the record onto CRM address fields without editing; it is always US. |
| neighborhoodNeighborhood | Text | Named neighborhood or unincorporated community around the business address (for example 'Capitol Hill', 'South Austin', 'Kendall'), Use it to route by territory inside a city and to open with a local reference. Blank when the address sits outside every named area. | Public gazetteers · US Census (CDP) | Derived | Tied to geocode (~92%); null outside a named polygon | Route by territory inside a city and open with a local reference. |
| time_zoneTime Zone | Text | Time zone of the business address, as the standard IANA name every dialer, CRM and scheduler accepts — 'America/New_York', 'America/Chicago', 'America/Denver', 'America/Los_Angeles', 'America/Phoenix'. Sort by it to work a list in local business hours. A name rather than a fixed offset on purpose: the offset moves with daylight saving, and Arizona never shifts. Taken from the address rather than the area code, so a ported number never moves a lead into the wrong calling window. Blank when the address could not be placed on the map. | USDOT/BTS NTAD (49 CFR Part 71) | Derived | Tied to geocode (~92%) | Sort a list so a rep dials each owner in their own business hours. |
| msa_nameMSA | Text | Metropolitan Statistical Area the business sits in (for example 'Tampa-St. Petersburg-Clearwater, FL'). | GoodLeads proprietary | Derived | Tied to geocode (~92%) | Report or carve territories by metro area. |
| msa_codeMSA Code (CBSA) | Text | OMB CBSA code for the business's metro area — joins cleanly to Census, BLS, and market datasets. Blank when the county sits outside every Metropolitan Statistical Area. | GoodLeads proprietary | Derived | Tied to geocode (~92%) | Join the record to Census, BLS or your own market data on the metro code. |
| county_fipsCounty FIPS | Text | Federal county FIPS code — useful for territory mapping and geographic joins. | US Census Bureau | Public | ~92% | Join the record to county-level data or territory maps. |
| neighborhood_income_bandNeighborhood Income | Text | Income band of the neighborhood around the business address (census-tract median household income, US Census Bureau ACS): 'Under $50K' through '$150K+'. New filings usually list the owner's home address, so this reads as the founder's neighborhood affluence — use it to pick the offer and the outreach order. An area statistic, not the contact's personal income. Blank when the tract has no reliable estimate. | US Census Bureau (ACS) | Derived | Tied to geocode (~92%) | Target or exclude by the income level of the neighbourhood around the address. |
| neighborhood_median_incomeNeighborhood Median Income | Number | The neighborhood's median household income in dollars (census tract, ACS 5-year estimates) — the raw figure behind Neighborhood Income, for spreadsheet sorting and custom thresholds. | US Census Bureau (ACS) | Derived | Tied to geocode (~92%) | Sort or set your own income thresholds on the neighbourhood's median household income. |
| county_nameCounty | Text | County of the principal business address, spelled out (for example 'Denver County') — the territory unit most sales teams carve by. Blank when the record has no county code. | US Census Bureau | Public | Present when the record has a county code | Carve territories by county, the unit most sales teams assign by. |
| latitudeLatitude | Number | Geocoded latitude of the principal address. | US Census Bureau | Public | ~92% | Plot the business on a map or run a radius search around your office. |
| longitudeLongitude | Number | Geocoded longitude of the principal address. | US Census Bureau | Public | ~92% | Pair it with latitude to test each record against your service-area boundaries. |
| area_codePhone Area Code | Text | First 3 digits of the primary phone — carve calling territories by area code without parsing phone_primary yourself. | GoodLeads proprietary | Derived | Matches phone coverage | Carve calling territories by area code without parsing the phone number. |
Roadmap
Address Mailability — for direct-mail customers
If your motion is a postal piece, you need CASS certification (DPV, DPC, CheckDigit) so the post office honors your bulk-rate discount. We don't ship these fields today. They're on the roadmap; CASS certification adds real per-record cost we want to bake into the right pricing tier before we ship.
If you have a direct-mail motion gated on these fields, tell us — we'll prioritize.
- dpv_code Planned Delivery Point Validation result (Y / N / S).
- dpv_footnotes Planned Reason codes when DPV partial-match.
- dpc Planned 2-digit Delivery Point Code (last two digits of barcode).
- check_digit Planned POSTNET / IMb check digit.
- cass_certified_at Planned Timestamp of CASS-cycle certification.
Section 04 · Part I
Industry Classification
We don't buy industry codes from a third party. We classify every entity ourselves at load time — rule-based fusion of suffix patterns, keyword matching, and entity-type rules. Confidence ships with every value. And we surface the result at three altitudes: our own GoodLeads taxonomy for sales segmentation, and standardized SIC + NAICS codes with their official titles for the CRM and BI tools that already speak those codes.
GoodLeads Taxonomy
Built for sales segmentation — the right altitude for outreach
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| industry_sectorIndustry Sector | Enum | High-level industry classification, standardized across states. | GoodLeads proprietary | Derived | ~96% | Group the list by broad industry to pick the verticals you sell into. |
| industry_nameIndustry | Text | Specific industry within the sector — more granular than industry_sector. | GoodLeads proprietary | Derived | ~96% | Narrow to the specific line of business your product fits. |
| industry_confidence_tierIndustry Confidence Tier | Enum | How sure the classification is: confirmed, likely, possible, or unknown. Values: Confirmed, Likely, Possible, Unknown. |
GoodLeads proprietary | Derived | Always present | Filter to Confirmed and Likely when a wrong industry would cost you, and review the rest before you scale. |
SIC + NAICS
Standardized codes at every granularity — for the tools that speak them
Every depth we ship is its own column. We never derive shallower codes from deeper on read — your filter on naics_2_digit = "54" is a real column, not a substring match. The file ships the 2-digit and 6-digit NAICS depths and the 2-digit and 4-digit SIC depths, each with its official title beside it.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| sic_2_digitSIC Major Group | Text | 1987 SIC 2-digit major group code. | GoodLeads proprietary | Derived | ~96% | Filter by SIC major group, the grouping many underwriting and credit systems use. |
| sic_2_digit_labelSIC Major Group Title | Text | Official 1987 SIC title for the major group code — the words beside the code (for example 81 is 'Legal Services'). Blank when the code has no official title on file. | GoodLeads proprietary | Derived | ~96% | Read the SIC major group in words instead of looking up the code. |
| sic_4_digitSIC Code | Text | 1987 SIC 4-digit industry code — the depth most B2B systems key on. | GoodLeads proprietary | Derived | ~96% | Filter or map to the 4-digit SIC code your systems already key on. |
| sic_4_digit_labelSIC Code Title | Text | Official 1987 SIC title for the 4-digit industry code (for example 8111 is 'Legal Services'). Blank when the code has no official title on file. | GoodLeads proprietary | Derived | ~96% | Read the SIC industry in words, for example in a report or an email merge. |
| naics_2_digitNAICS Sector | Text | 2017 NAICS 2-digit sector code. | GoodLeads proprietary | Derived | ~96% | Filter by NAICS sector, the broadest federal industry grouping. |
| naics_2_digit_labelNAICS Sector Title | Text | Official 2017 NAICS title for the sector code (for example 54 is 'Professional, Scientific, and Technical Services'). Blank when the code has no official title on file. | GoodLeads proprietary | Derived | ~96% | Read the NAICS sector in words instead of looking up the code. |
| naics_6_digitNAICS National Industry | Text | 2017 NAICS 6-digit national industry code — the deepest official NAICS depth. | GoodLeads proprietary | Derived | ~96% | Map to the NAICS code your CRM or underwriting rules use, at the deepest official level. |
| naics_6_digit_labelNAICS National Industry Title | Text | Official 2017 NAICS title for the 6-digit national industry code (for example 541110 is 'Offices of Lawyers'). Blank when the code has no official title on file. | GoodLeads proprietary | Derived | ~96% | Read the NAICS industry in words, for example in a report or an email merge. |
| google_business_categoryGoogle Business Category | Text | Google Business category — the category local-marketing buyers target on Google. | GoodLeads proprietary | Derived | Classification-dependent — null where the industry mapping is ambiguous | Target the category local-marketing buyers choose on Google Business. |
| mccMerchant Category Code | Text | ISO 18245 card-network MCC — the underwriting vocabulary of payment processors. Blank when the business type is not a card-accepting merchant category. | GoodLeads proprietary | Derived | Classification-dependent — null where the industry mapping is ambiguous | Match the business to the card-network category a payment processor underwrites by. |
Section 05 · Part I
Property Intelligence
Where most B2B data products stop, we begin. Every principal address spatial-joined against millions of county parcel boundaries. A residential principal address is a different sales motion than a commercial one — and a vacant-land principal address is usually a shell company you want to exclude. We surface all of that at load time.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| property_classificationProperty Classification | Enum | Type of property at the business address (residential, commercial, industrial, and so on). Residential plus a single entity usually means an owner-operator. Values: RESIDENTIAL, COMMERCIAL, INDUSTRIAL, AGRICULTURAL, MULTI_FAMILY, MIXED_USE, VACANT, EXEMPT, UNKNOWN. |
County parcel data → GoodLeads classification | EnrichedDerived |
~83% | Separate home-based businesses from those at commercial property when your offer depends on it. |
| property_is_vacantProperty Is Vacant | Boolean | Whether the business address sits on vacant land. | County parcel data → GoodLeads classification | EnrichedDerived |
~83% | Flag addresses on vacant land to deprioritise, or to find new construction. |
| property_assessed_valueProperty Assessed Value | Number | Assessed value of the property in dollars. | County parcel data | Enriched | ~83% | Gauge the scale of the property behind the address before you size the offer. |
Section 06 · Part II
Registered Agent Intelligence
Proprietary IP. The state gives you a name and address. We give you the kind of agent behind the filing (a market tier), whether the owner is their own agent, and a Go-to-Market segment — so you can tell a self-represented founder from a business that went through a national filing service.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| registered_agent_nameRegistered Agent | Text | Name of the registered agent on the filing. | SOS filing | Public | Always present | See who the state lists as the business's registered agent, and spot businesses that share one. |
| registered_agent_market_tierRA Market Tier | Enum | Market tier of the registered agent — the owner acting as their own agent, a boutique firm, or a national service. Values: premium, midmarket, budget, local, individual, state_agency, suspicious, unknown. |
GoodLeads proprietary | Derived | Always present | Segment by the kind of agent behind the filing: the owner, a boutique firm, or a national service. |
| registered_agent_segmentGTM Segment | Enum | Go-to-market segment from registered-agent analysis. Self-represented businesses are typically the most reachable. Values: owner_operator, budget_formation, midmarket_formation, premium_established, suspicious_exclude, unclassified. |
GoodLeads proprietary | Derived | Always present | Pick the segments that fit your offer; self-represented owners are typically the most reachable. |
| registered_agent_is_commercialRA Is Commercial | Boolean | Whether the registered agent is a commercial service rather than the owner. | GoodLeads proprietary | Derived | Always present | Separate businesses using a commercial agent service from those where the owner is the agent. |
| registered_agent_is_ownerRA Self-Represented | Boolean | Whether the owner filed as their own registered agent — a strong direct-reachability signal. | GoodLeads proprietary | Derived | Always present | Prioritise owners who filed as their own agent, who are the most directly reachable. |
| registered_agent_is_attorneyRA Is Attorney | Boolean | Whether the registered agent is an attorney or law firm. | GoodLeads proprietary | Derived | Always present | Spot filings made through an attorney, to route or exclude them. |
Section 07 · Part III
The Contact
The person you actually call. We never ship info@ aliases or main switchboard numbers — every contact is name-matched to an officer, owner, or self-representing RA. Up to three phones and two emails per contact, ranked by reachability and recency.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| contact_nameContact Name | Text | Full name of the person who can authorize a buy for this business. | SOS filing · Skip-trace provider | PublicEnriched |
Always present | Address the person who can authorise a purchase by name. |
| first_nameFirst Name | Text | The contact's first name, split from contact_name — maps straight onto CRM first-name fields. | GoodLeads proprietary | Derived | Always present | Map straight onto your CRM first-name field for a personalised opener. |
| last_nameLast Name | Text | The contact's last name, split from contact_name — maps straight onto CRM last-name fields. | GoodLeads proprietary | Derived | Always present | Map straight onto your CRM last-name field. |
| role_titleRole Title | Text | The contact's role on the filing — standardized (e.g. Manager, Managing Member, President, Director). Blank where the state does not publish titles. | SOS filing | Public | State-dependent | Match your pitch to the person's role on the filing. |
| role_is_decision_makerDecision Maker | Boolean | True when the contact's role can bind the business (owner, manager, managing member, president, etc.) — the person who can authorize a purchase. | SOS filing | Public | State-dependent | Keep only contacts whose role can bind the business. |
| contact_coverageContact Coverage | Enum | Which channels this record carries: Phone + Email, Phone only, Email only, or No channel yet. Computed from the phone and email columns in this file. Values: Email only, No channel yet, Phone + Email, Phone only. |
GoodLeads proprietary | Derived | Always present | Choose the channel mix before you build a campaign: phone and email, phone only, email only, or no channel yet. |
| phone_primaryPhone | Phone (E.164) | Best phone number for the contact, in +1 E.164 format — paste-ready for dialers and CRMs. | Curated enrichment channel | Enriched | Enrichment-dependent — measured per delivery (see the sample cover sheet) | Dial or text the best number we found; it is formatted for dialers and CRMs. |
| phone_2Backup Mobile | Phone (E.164) | Verified mobile backup — a second mobile number verified to the same standard as the primary. Blank when no second number qualifies; never an unverified guess. | Curated enrichment channel | Enriched | Present when a second mobile verifies | Call a verified second mobile when the first does not connect. |
| email_primaryEmail | Best email address for the contact, selected from every validated candidate. | Curated enrichment channel | Enriched | Enrichment-dependent — measured per delivery (see the sample cover sheet) | Send your first email to the best address we selected from every one we checked. | |
| has_phoneHas Phone | Boolean | Whether the record carries at least one phone number. | GoodLeads proprietary | Derived | Always present | Filter to records you can call. |
| has_emailHas Email | Boolean | Whether the record carries at least one email address. | GoodLeads proprietary | Derived | Always present | Filter to records you can email. |
Section 08 · Part III
Email Validation
Every email runs through our validation engine. We report the deliverability result, the inbox-activity recency, the infrastructure provider, and whether the name on the inbox matches the person on the filing. Most providers ship "valid" or "invalid." We ship the full diagnostic so you can route catch-all, free-provider, and stale-inbox traffic differently than confirmed-active mailboxes.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| email_deliverability_statusEmail Status | Enum | Deliverability verdict for the primary email: valid means send-safe; catch-all means the domain accepts all mail; unknown means unverified. Values: catch-all, unknown, valid. |
Email validation engine | Enriched | Vendor-conditional | Send to valid addresses; treat catch-all with caution and unknown as unverified. |
| email_active_in_daysEmail Active (days) | Number | How recently the primary email showed activity, in days. Lower is fresher. | Email validation engine | Enriched | Vendor-conditional | Rank sends by how recently the inbox was active; lower numbers are fresher. |
| email_2Email 2 | Second-ranked email address for the contact. | Curated enrichment channel | Enriched | Present when a second address validates | Add a second address to a sequence, or use it when the first bounces. | |
| email_3Email 3 | Third-ranked email address for the contact. | Curated enrichment channel | Enriched | Present when a third address validates | Keep a third address as a last fallback. | |
| email_is_free_providerFree Email Provider | Boolean | True when the primary email is a free personal mailbox (gmail, yahoo, outlook); false when it is on the owner's own domain. Blank when there is no email. | GoodLeads proprietary | Enriched | Present whenever there is an email | Send a different opener to a free mailbox than to an owner on their own domain. |
| email_activity_foundEmail Activity Found | Boolean | Whether recent activity was observed on the primary email. | Email validation engine | Enriched | Vendor-conditional | Filter to inboxes showing recent activity before a high-stakes send. |
Section 09 · Part III
Phone Validation
Every phone is classified by line type before we ship it. Mobile, landline, and VoIP have different connect rates, different TCPA implications, and different best-time-to-call patterns. You should treat them differently — we make that possible.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| phone_typePhone Type | Enum | Line type of the primary phone: mobile, landline, or voip. Mobile connects best. Values: landline, mobile, unknown, voip. |
Curated enrichment channel | Enriched | Vendor-conditional | Send mobile numbers to text and call first, and route landlines to a call-only step. |
Section 10 · Part IV
Reachability Score
0–100 composite answering one question: can we reach this person? Described the way we describe every score: the question it answers, the families of signals behind it, and the guards that keep it from overstating. Version: reachability_v1.0.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| reachability_scoreReachability Score | Number | 0-100 composite answering 'can you reach them?' — phone, email validity, contact quality and more, in one number. | GoodLeads proprietary | Derived | Present for scored records | Sort the list by how likely you are to reach the person, from 0 to 100. |
| reachability_tierReachability Tier | Enum | Named reachability band: On Fire, Very Hot, Hot, Warm, Cold. Withheld marks records we recommend against dialing. Values: Cold, Hot, On Fire, Very Hot, Warm, Withheld. |
GoodLeads proprietary | Derived | Present for scored records; a small set is Withheld | Work On Fire and Very Hot first, and skip Withheld records. |
Signal Families
What the score reads
| Signal family | What it reads |
|---|---|
| Phone | A phone on file, in service. |
| Email deliverability | The mailbox accepts mail. |
| Email activity | Someone has used the inbox recently. |
| Identity | The person is confirmed across independent sources, and the name on the inbox matches the name on the filing. |
| Place | The address is placed on the map — county and neighborhood known. |
| Mail provider | The email sits on a real mail provider. |
| Line of business | The industry is known with confidence. |
Guards — what the score will not overstate
No way in, no heat. A record with no phone and no usable email can't score past the bottom of Warm, whatever else we know about it. A way to reach the person is the floor everything else builds on.
On Fire takes a phone and an email. A great phone with no usable email tops out at Very Hot.
Never-Downgrade Protection
Once a record reaches a score, a subsequent reload cannot lower it. Paid enrichment is irreversible — the data is too. A record that hit Very Hot in February stays at Very Hot even if the score model re-evaluates lower on a re-run.
Section 11 · Part IV
Contact Relevance Score
0–100 composite answering an orthogonal question: is this the RIGHT person to sell to? A contact can be highly reachable but the wrong person — a commercial RA employee instead of the founder. This score separates them. Version: contact_relevance_v1.1.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| contact_relevance_scoreContact Relevance Score | Number | 0-100 composite answering 'is this the right person to sell to?'. | GoodLeads proprietary | Derived | Present for scored records | Rank by how likely the contact is the right person to sell to, from 0 to 100. |
| contact_relevance_tierContact Relevance Tier | Enum | Named relevance band, from Decision Maker down to Unlikely Decision Maker. Values: Decision Maker, Likely Decision Maker, Probable Contact, Uncertain Contact, Unlikely Decision Maker. |
GoodLeads proprietary | Derived | Present for scored records | Keep Decision Maker and Likely Decision Maker for your primary campaign. |
Signal Families
What the score reads
| Signal family | What it reads |
|---|---|
| Named on the filing | The person is named on the state filing, and in what role — an officer or owner reads differently from an agent. |
| Their own registered agent | A founder who files alone and acts as their own agent. The strongest single sign of an owner. |
| Shared address | How many businesses share this address. |
| Shared person | How many businesses this person appears on. |
| Name in the business name | The person's name appears in the business name (e.g., "Smith Consulting LLC"). |
| Kind of registered agent | An individual agent reads differently from a commercial service. |
| Shape of the company | A single-owner LLC reads differently from a many-officer corporation. |
Guards — what the score will not overstate
A commercial agent's office is not a founder. A person who appears on many businesses, at an address many businesses share, counts against the record as a possible commercial-agent pattern — a founder who is their own registered agent and holds several businesses at one address can still outscore it.
The filer is not the buyer. The attorney or service that filed the paperwork is flagged and set aside, never sold as the decision-maker.
Section 12 · Part IV
Contact Confidence Score
0–100 composite answering a third orthogonal question: are we confident this email or phone really belongs to this person? A reachable, relevant contact can still be the wrong identity — a forwarded inbox, a family-shared phone, a name collision. This score isolates that risk. Never zero — every contact has some chance of being real. Version: contact_confidence_v2.1.
| Field | Type | Description / Values | Source | License | Coverage | Use case |
|---|---|---|---|---|---|---|
| contact_confidence_scoreContact Confidence Score | Number | 0-100 composite answering 'is this a real, current, deliverable person?'. | GoodLeads proprietary | Derived | Present when the contact has been enriched/validated (null otherwise) | Rank by how sure we are the phone or email really belongs to this person, from 0 to 100. |
| contact_confidence_tierContact Confidence Tier | Enum | Named confidence band: Verified Contact, Likely Contact, Possible Contact, Uncertain Contact. Values: Likely Contact, Possible Contact, Uncertain Contact, Verified Contact. |
GoodLeads proprietary | Derived | Present when the contact has been enriched/validated (null otherwise) | Send first to Verified Contact and Likely Contact. |
Signal Families
What the score reads
| Signal family | What it reads |
|---|---|
| Name in the email address | The email address itself carries the person's name. |
| Name on the inbox | The name on the inbox matches the name on the filing. |
| A mailbox in use | The mailbox is deliverable, and someone is reading it. |
| The founder's own line | A mobile phone on a founder who is their own registered agent — the founder's personal line. |
| Home address | A home address rather than a shared commercial or virtual office. |
| Name in the business name | The person's name appears in the business name. |
| How the person was matched | How the person was matched to the record. |
Guards — what the score will not overstate
Risky mailboxes pull confidence down. Spam traps, role mailboxes (info@, support@) and suppression-listed addresses are caught before they can hurt your sender reputation.
A contradicting inbox pulls confidence down. When the name on the inbox differs from the filing on both first and last name, it reads as a forwarded or borrowed inbox.
Three Orthogonal Scores
Reachability answers "can we reach them?" · Relevance answers "are they the right person?" · Confidence answers "is this contact really them?" A lead can be high on any two and low on the third. Most providers ship one score (or none). We ship three — Reachability and Contact Relevance on every record, Contact Confidence once a phone or email has been found and checked — each with its tier and the families of signals behind it. How they combine is ours.
Reference · Sample
Sample Record
One record, keyed by the same column names as your file. The shape, sparsity, and value patterns your pipeline will actually see. Use this to size your ingestion code, mock your CRM mapping, and confirm the deliverable matches what your team needs before any contract conversation.
{
"lead_ref": "GL-CO-999999",
"entity_name": "MOUNTAIN VIEW DENTAL LLC",
"trade_name": "Mountain View Family Dentistry",
"entity_type": "LLC",
"entity_is_foreign": false,
"business_origin": "Newly formed in Colorado",
"home_state": null,
"has_federal_tax_id": false,
"federal_tax_id": null,
"federal_tax_id_status": "Not listed",
"filing_kind": "formation",
"lead_class": "Just started",
"new_business_tier": "Confirmed new",
"new_business_reason": "First-ever filing for this business · no earlier filings on record",
"last_event": "Formed",
"last_event_date": "2026-10-02",
"prior_entity_ref": null,
"prior_entity_formation_date": null,
"entity_is_professional": false,
"entity_is_nonprofit": false,
"entity_is_public_benefit": false,
"status": "active",
"state": "CO",
"state_entity_id": "20261234567",
"formation_date": "2026-10-01",
"filed_date": "2026-10-01",
"published_date": "2026-10-02",
"pulled_date": "2026-10-03",
"verified_date": "2026-10-04",
"days_filing_to_delivery": 4,
"delivery_number": 3,
"delivery_date": "2026-10-15",
"principal_address": "1422 ELK PARK DR, BOULDER, CO 80303",
"principal_city": "Boulder",
"principal_zip": "80303",
"address_state": "CO",
"address_source": "State Filing",
"working_address": null,
"country": "US",
"neighborhood": "Table Mesa",
"time_zone": "America/Denver",
"msa_name": "Boulder, CO",
"msa_code": "14500",
"county_fips": "08013",
"neighborhood_income_band": "$100K-$150K",
"neighborhood_median_income": 118400,
"county_name": "Boulder County",
"latitude": 39.985,
"longitude": -105.197,
"property_classification": "Residential",
"property_is_vacant": false,
"property_assessed_value": 745000,
"industry_sector": "Healthcare",
"industry_name": "Dental Practice",
"industry_confidence_tier": "Confirmed",
"sic_2_digit": "80",
"sic_2_digit_label": "Health Services",
"sic_4_digit": "8021",
"sic_4_digit_label": "Offices and Clinics of Dentists",
"naics_2_digit": "62",
"naics_2_digit_label": "Health Care and Social Assistance",
"naics_6_digit": "621210",
"naics_6_digit_label": "Offices of Dentists",
"google_business_category": "Dentist",
"mcc": "8021",
"registered_agent_name": "JANE SMITH",
"registered_agent_market_tier": "individual",
"registered_agent_segment": "owner_operator",
"registered_agent_is_commercial": false,
"registered_agent_is_owner": true,
"registered_agent_is_attorney": false,
"contact_name": "Jane Smith",
"first_name": "Jane",
"last_name": "Smith",
"contact_ref": "GLC-12873",
"role_title": "Manager",
"role_is_decision_maker": true,
"contact_coverage": "Phone + Email",
"phone_primary": "+13035551247",
"phone_type": "mobile",
"area_code": "303",
"phone_2": "+13035554089",
"email_primary": "jane.smith@example.com",
"email_deliverability_status": "valid",
"email_active_in_days": 60,
"email_2": "jsmith@example.org",
"email_3": null,
"email_is_free_provider": false,
"email_activity_found": true,
"has_phone": true,
"has_email": true,
"reachability_score": 87,
"reachability_tier": "On Fire",
"contact_relevance_score": 88,
"contact_relevance_tier": "Decision Maker",
"contact_confidence_score": 89,
"contact_confidence_tier": "Verified Contact",
"owner_group_code": null,
"owner_group_size": null,
"owner_group_owner_name": null,
"owner_group_operating_business_name": null
}
Appendix A
Coverage by State
Observed fill rates from production runs (refreshed monthly), anchored to the sellable cohort — not all pulled records. Phone and email rates measured against operating businesses only, because those are the records we expect you to charge against. Forecasts for newly-onboarded states are dashed and prefixed with "~" so they're never mistaken for measurement.
Solid cell =
data-status="observed" · production fill rate, sellable cohort
Dashed cell = data-status="forecast" · projection · not yet measured
| Stage / Source | CO | FL | VA | NY | GA next |
|---|---|---|---|---|---|
| SOS filing fields | 100% | 100% | 100% | 100% | 100% |
| Sellable inventory (% of pull) | 78% | 82% | 84% | 71% | — |
| Geocoding | 90% | 92% | 93% | 92% | — |
| MSA tagging | 89% | 91% | 92% | 90% | — |
| Industry classification (GoodLeads + SIC + NAICS) | 95% | 96% | 96% | 96% | — |
| Property classification | 76% | 88% | 84% | 80% | — |
| RA intelligence | 100% | 100% | 100% | 100% | — |
| Phone fill (sellable cohort) | 56% | 64% | 87% | 51% | 45% |
| Email fill (sellable cohort) | 41% | 53% | 59% | 38% | 35% |
| Email validation | 48% | 48% | 48% | 48% | — |
| Reachability score | 100% | 100% | 100% | 100% | — |
| Contact Relevance score | 100% | 100% | 100% | 100% | — |
| Contact Confidence score | 100% | 100% | 100% | 100% | — |
Appendix B
What's Different
A scraper ships you state data with a timestamp. We ship you that — plus seven things no other B2B data product delivers.
— 01
Three Orthogonal Scores
Reachability ("can we reach them?"), Contact Relevance ("are they the right person?"), Contact Confidence ("is this contact really them?"). Plus 15+ derived classifications — Industry, Property Type, RA Market Tier, GTM Segment, Formation Service, RA Portfolio Shape, Density signals, Entity Archetype, Enrichment Strategy. All computed by us.
— 02
Sellable vs. Held Inventory
We explicitly hold back records that won't convert — mail-drops, single-asset property LLCs, asset-protection holdings. You're never billed for held records. Competitors ship them all and let you eat the bounce.
— 03
Cross-State Entity Resolution
Same RA, same contact — identified across every live state at load time. Without you doing any joins.
— 04
Per-Field Provenance
Every value carries source, license, timestamp, method, and version. Audit any cell. Most vendors ship one timestamp per record. We ship five per field.
— 05
Per-State Semantic Mapping
"What does mailing address mean in NY vs. FL vs. CO?" We've solved that. Your CRM sees one canonical schema across 50 state formats.
— 06
Confidence on Every Derivation
No value ships without a tier or score telling you how much to trust it. Every score names its question, its signal families and its guards — documented in the score sections.
— 07
Field-Level License Classification
PUBLIC_RECORD, ENRICHED, DERIVED — plus stacked-license support for derivations on enriched inputs. Your compliance team can reason about residency, sharing, and resale at the cell level.