City id
Numeric code for the city or municipality containing the individual's address. Known or imputed for 62.7 million addresses — 52.3% of the addresses Faraday knows.
At a glance
- Coverage today
- 52.3%
- Typical coverage
- 52.2%
- Addresses with a value
- 62.7M
- Share in largest category
- 4.0%
- Most values come
- from the address
- Latest collection
- Jan 1, 2020
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
Share of addresses in each category. 99+ categories, of which the 20 largest are shown, with 4.0% in the largest.
Every category
99+ categoriesThe chart above draws the 20 largest. Search here for one it does not. This list holds the 100 most common; rarer values are not named.
- 36510004.0%2,508,093 addresses
- 06440001.7%1,094,887 addresses
- 17140001.4%853,075 addresses
- 48350001.1%699,474 addresses
- 42600000.9%554,296 addresses
- 04550000.8%507,095 addresses
- 48650000.7%460,690 addresses
- 06660000.7%436,432 addresses
- 48190000.6%402,976 addresses
- 12350000.6%378,783 addresses
- 39180000.6%362,723 addresses
- 37120000.6%351,792 addresses
- 48050000.5%327,170 addresses
- 48270000.5%310,399 addresses
- 08200000.5%302,743 addresses
- 06670000.5%298,840 addresses
- 53630000.4%278,150 addresses
- 06680000.4%270,746 addresses
- 26220000.4%263,851 addresses
- 40550000.4%260,385 addresses
- 11500000.4%258,770 addresses
- 25070000.4%247,950 addresses
- 41590000.4%245,571 addresses
- 32400000.4%235,555 addresses
- 47480000.4%220,603 addresses
- 24040000.4%219,953 addresses
- 55530000.3%208,394 addresses
- 48240000.3%206,908 addresses
- 35020000.3%201,624 addresses
- 08160000.3%194,502 addresses
- 29380000.3%193,953 addresses
- 13040000.3%185,288 addresses
- 37550000.3%181,856 addresses
- 04770000.3%180,937 addresses
- 51820000.3%167,564 addresses
- 04460000.3%167,056 addresses
- 31370000.3%165,492 addresses
- 39160000.3%162,594 addresses
- 06640000.3%162,594 addresses
- 40750000.3%158,009 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
Share of addresses holding a value at each monthly snapshot. A value carries forward for one year.
How we arrive at a value
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 52.3% sits on the catalog’s own coverage range.
Higher coverage than 64% of address-level attributes in the catalog
Freshness
Whether the values reflect today. A long gap since the latest collection 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.
Contribution ledger
1 ingestion1 authority contributed since Jan 2020.
| Observed | Ingested | Count | ID |
|---|---|---|---|
| 119,048,853 | e84435bf-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 City id back in real time.
- Add
city_idto a project. - Send an email, phone, or address to the project's append endpoint. The response carries City 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":{"city_id":"3651000"}}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.
- city_
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