Village id

Text

Numeric code for the village containing the individual's address. Known or imputed for 3.1 million addresses — 2.6% of the addresses Faraday knows.

At a glance

Coverage today
2.6%
Typical coverage
2.6%
Addresses with a value
3.1M
Share in largest category
0.9%
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.

Share by category

n = 3,124,369

Share of addresses in each category.

No single value is common: at least 99 distinct values, the largest holds 0.9% of addresses with a value, and the 20 largest together hold 12.7%.

Show the 20 most common
1702154
0.9%
1768003
0.9%
1757225
0.8%
1707133
0.7%
1756640
0.7%
1770122
0.7%
1275812
0.7%
1754885
0.7%
1775484
0.7%
1754820
0.7%
1720591
0.6%
1751089
0.6%
1221150
0.6%
1729938
0.5%
1735411
0.5%
1744407
0.5%
5551000
0.5%
1709447
0.5%
1760287
0.5%
1262100
0.4%
Distinct categories
99+
Share in largest category
0.9%
Share in top 3 categories
2.6%

Every category

99+ categories

The 20 most common are listed above. Search here for any other. This list holds the 100 most common; rarer values are not named.

  • 17021540.9%28,837 addresses
  • 17680030.9%28,491 addresses
  • 17572250.8%24,408 addresses
  • 17071330.7%22,350 addresses
  • 17566400.7%21,872 addresses
  • 17701220.7%21,844 addresses
  • 12758120.7%21,689 addresses
  • 17548850.7%21,545 addresses
  • 17754840.7%20,875 addresses
  • 17548200.7%20,557 addresses
  • 17205910.6%18,896 addresses
  • 17510890.6%18,731 addresses
  • 12211500.6%18,127 addresses
  • 17299380.5%17,083 addresses
  • 17354110.5%16,728 addresses
  • 17444070.5%16,304 addresses
  • 55510000.5%15,931 addresses
  • 17094470.5%14,867 addresses
  • 17602870.5%14,549 addresses
  • 12621000.4%13,880 addresses
  • 17040130.4%13,673 addresses
  • 17534810.4%13,299 addresses
  • 36331390.4%13,135 addresses
  • 17113320.4%13,050 addresses
  • 17810870.4%12,975 addresses
  • 17731570.4%12,846 addresses
  • 17232560.4%12,502 addresses
  • 17654420.4%12,406 addresses
  • 36274850.4%12,338 addresses
  • 17832450.4%12,116 addresses
  • 55548750.4%11,834 addresses
  • 17568870.4%11,459 addresses
  • 17367500.4%11,396 addresses
  • 36767050.4%11,216 addresses
  • 17320180.3%10,906 addresses
  • 17002430.3%10,765 addresses
  • 17006850.3%10,685 addresses
  • 17513490.3%10,593 addresses
  • 17530000.3%10,570 addresses
  • 17420280.3%10,295 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

2.6% 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 2.6% sits on the catalog’s own coverage range.

catalog min 0%max 100%

Higher coverage than 10% 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

1 ingestion

1 authority contributed since Jan 2020.

ObservedIngestedCountID
119,048,853e84435bf-fdae-464b-ad1b-45a5aca06bc2

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 Village id back in real time.

  1. Add village_id to a project.
  2. Send an email, phone, or address to the project's append endpoint. The response carries Village id 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":{"village_id":"1702154"}}
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.
village_id
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