State

Text

Two-letter USPS state or territory abbreviation for the individual's mailing address. Known or imputed for 116.5 million addresses — 97.1% of the addresses Faraday knows.

At a glance

Coverage today
97.1%
Typical coverage
97.2%
Addresses with a value
116.5M
Share in largest category
9.7%
Most values come
from the address
When latest collection arrived
Apr 20, 2026

How the categories split

How values are spread across the records that have one. Use it to check that the attribute tells records apart: when one value holds nearly everyone, it will not separate audiences much. Categories are ranked by share, largest first. “All other values” groups the smallest into one bar.

Share by category

n = 116,529,705

Share of addresses in each category. 51 categories, of which the 20 largest are shown, with 9.7% in the largest.

CA
9.7%
TX
8.3%
FL
7.5%
NY
5.5%
OH
4.1%
PA
4.1%
IL
3.7%
NC
3.7%
MI
3.4%
GA
3.2%
VA
2.6%
NJ
2.6%
TN
2.3%
WA
2.2%
MA
2.2%
IN
2.1%
AZ
2.0%
MO
2.0%
WI
2.0%
CO
1.9%
All other values
24.9%
Distinct categories
51
Share in largest category
9.7%
Share in top 3 categories
25.5%

Every category

51 categories

The chart above draws the 20 largest. Search here for one it does not.

  • CA9.7%11,320,836 addresses
  • TX8.3%9,660,592 addresses
  • FL7.5%8,708,278 addresses
  • NY5.5%6,455,635 addresses
  • OH4.1%4,748,158 addresses
  • PA4.1%4,739,507 addresses
  • IL3.7%4,353,467 addresses
  • NC3.7%4,269,052 addresses
  • MI3.4%4,015,361 addresses
  • GA3.2%3,722,939 addresses
  • VA2.6%3,088,019 addresses
  • NJ2.6%3,024,594 addresses
  • TN2.3%2,627,867 addresses
  • WA2.2%2,568,097 addresses
  • MA2.2%2,544,827 addresses
  • IN2.1%2,500,407 addresses
  • AZ2.0%2,382,547 addresses
  • MO2.0%2,327,779 addresses
  • WI2.0%2,299,483 addresses
  • CO1.9%2,180,527 addresses
  • MD1.8%2,144,811 addresses
  • MN1.8%2,080,494 addresses
  • SC1.8%2,047,394 addresses
  • AL1.7%1,995,186 addresses
  • LA1.5%1,748,042 addresses
  • KY1.4%1,674,491 addresses
  • OK1.3%1,480,985 addresses
  • OR1.3%1,479,902 addresses
  • CT1.1%1,336,741 addresses
  • IA1.0%1,184,527 addresses
  • AR1.0%1,177,615 addresses
  • NV1.0%1,137,165 addresses
  • MS0.9%1,025,594 addresses
  • UT0.8%970,734 addresses
  • KS0.8%958,011 addresses
  • NE0.6%690,090 addresses
  • NM0.6%642,235 addresses
  • WV0.5%627,535 addresses
  • ID0.5%614,932 addresses
  • ME0.5%549,139 addresses

Coverage

How widely Faraday has this attribute, and how precise its values are. How many of your own records get a value also depends on how many of them Faraday matches. The state map shows where coverage is thin. Coverage over time shows whether it is growing or shrinking.

Coverage by state

Percentage of addresses in each state with a value.

Coverage over time

97.1% today

Share of addresses holding a value at each monthly snapshot. A value carries forward for one year.

Jan 20Jun 24Feb 25Jun 25Nov 25Mar 26Nov 26

How we arrive at a value

Latest collection: 119,389,496 addresses

Whether a value was observed on the person themselves, carried from their address, or estimated from the people around them.

On the person — 0%
Not used for this attribute — no value is inherited this way.
From address — 100%
Carried from what we know about the household at their address.
From geography — 0%
Not used for this attribute — no value is inherited this way.

Coverage, in context

Where 97.1% sits on the catalog’s own coverage range.

catalog min 0%max 100%

Higher coverage than 84% of address-level attributes in the catalog

Freshness

Whether the values reflect today. A long gap since the latest collection arrival means they may lag behind what is true now.

Collections

How recently this was collected, and how often a new collection arrives. Each bar is one collection, sized by how many addresses it carried. Gaps are real — collection is periodic, not continuous.

Apr 20, 2026
when latest collection arrived
Jan 1, 2020
data as of
6 months 25 days
since the latest collection arrival
Jan 20
Data as of

Contribution ledger

2 ingestions

1 authority contributed since Jan 2020.

ObservedIngestedCountID
119,048,853e84435bf-fdae-464b-ad1b-45a5aca06bc2
119,016,289dd311395-716d-40ea-98f2-81aeadd883f8

Related attributes

Attributes whose descriptions are closest to this one.

Neighbors found Oct 2026.

Use it in the API

Send an email, phone, or address. Get State back in real time.

  1. Add state to a project.
  2. Send an email, phone, or address to the project's append endpoint. The response carries State for the matched person.
curl -X POST 'https://api.pro.faraday.ai/v1/projects/YOUR_PROJECT_ID/append' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
      "email": "jane.doe@example.com"
    }'
→ {"attributes":{"state":"CA"}}
Get it by APIAppend to a fileRead the API docs

Technical details

null in any row means the label does not apply, or is not recorded, for this attribute.

API name
The field to request through the API, and the key it comes back under in a payload.
state
Category
The catalog group the attribute is filed under.
fig/geography
Type · unit
The kind of value and, where it has one, its unit of measure. Counts on this page are in addresses, whatever the unit.
Text
Statistical type
How the values are meant to be read: a measured amount, one of a ranked set, one of an unordered set, or several from an unordered set. The chart's form comes from the published values; for categories without a rank prefix, this label decides whether they are listed in rank order or by size.
categorical
Allowed values
The full list of values, when the attribute has a fixed set.
null
Derivations
How the value is produced, each with its definition.
Unspecified
How values combine
How the values from the attribute's sources become the one value delivered.
Read from a single source field.
Directionality
For ordered values, what a higher value means.
null
Deprecation
True when the attribute is being retired; choose another for new work.
false
API reference