# U.S. Census Bureau API: Get address details > Matches a US street address and returns its city or place, county, state, ZIP code, census tract, congressional and state legislative districts, coordinates and FIPS codes. Districts follow the Census Geocoder's current geography vintage and may differ from sitting representation. Unofficial. Not affiliated with or endorsed by U.S. Census Bureau. - Page: https://fous.com/methods/census.gov/get-address-details - Method: `census.gov/get_address_details`, version 1 - Website: census.gov - Returns: matched address, city or place, county, state, ZIP, census tract, districts, coordinates, FIPS codes, map link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `address` | string | yes | `"1600 Pennsylvania Ave NW, Washington, DC 20500"` | Full US street address, such as 350 5th Ave, New York, NY 10118. | ## Output From a run on Oct 23, 2026. Its input: ```json { "address": "1600 Pennsylvania Ave NW, Washington, DC 20500" } ``` Its output: ```json { "state": "District of Columbia", "county": "District of Columbia", "latitude": 38.898702605245, "zip_code": "20500", "longitude": -77.035189204737, "block_fips": "110019800001034", "state_fips": "11", "tract_fips": "11001980000", "county_fips": "001", "census_tract": "Census Tract 9800", "city_or_place": "Washington", "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500", "google_maps_link": "https://www.google.com/maps/search/?api=1&query=1600%20PENNSYLVANIA%20AVE%20NW%2C%20WASHINGTON%2C%20DC%2C%2020500", "congressional_district": "Delegate District (at Large)", "state_legislative_district_lower": null, "state_legislative_district_upper": "Ward 2" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"census.gov/get_address_details","input":{"address":"1600 Pennsylvania Ave NW, Washington, DC 20500"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What census tract and congressional district is 1600 Pennsylvania Ave NW, Washington, DC 20500 in? - Look up the county, ZIP code, and FIPS codes for 233 S Wacker Dr, Chicago, IL 60606. - Which state legislative districts cover 1 Infinite Loop, Cupertino, CA 95014? I need the coordinates too. - Can you match the address 742 Evergreen Terrace, Springfield, OR 97477 and give me its place name and map link? - I'm verifying a mailing list. Please geocode 500 W Temple St, Los Angeles, CA 90012 and tell me its census tract. ## Input schema ```json { "type": "object", "required": [ "address" ], "properties": { "address": { "type": "string", "description": "Full US street address, such as 350 5th Ave, New York, NY 10118." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "matched_address", "city_or_place", "county", "state", "zip_code", "census_tract", "congressional_district", "state_legislative_district_upper", "state_legislative_district_lower", "google_maps_link", "latitude", "longitude", "state_fips", "county_fips", "tract_fips", "block_fips" ], "properties": { "state": { "type": [ "string", "null" ], "description": "State name." }, "county": { "type": [ "string", "null" ], "description": "County name." }, "latitude": { "type": [ "number", "null" ], "description": "Latitude of the matched location.", "x-fous-developer": true }, "zip_code": { "type": [ "string", "null" ], "description": "ZIP code in the matched address." }, "longitude": { "type": [ "number", "null" ], "description": "Longitude of the matched location.", "x-fous-developer": true }, "block_fips": { "type": [ "string", "null" ], "description": "Full 15-digit census block FIPS identifier (state, county, tract and block).", "x-fous-developer": true }, "state_fips": { "type": [ "string", "null" ], "description": "Two-digit state FIPS code.", "x-fous-developer": true }, "tract_fips": { "type": [ "string", "null" ], "description": "Full 11-digit census tract FIPS identifier (state, county and tract).", "x-fous-developer": true }, "county_fips": { "type": [ "string", "null" ], "description": "Three-digit county FIPS code.", "x-fous-developer": true }, "census_tract": { "type": [ "string", "null" ], "description": "Census tract name." }, "city_or_place": { "type": [ "string", "null" ], "description": "Incorporated place, census-designated place, or matched city." }, "matched_address": { "type": [ "string", "null" ], "description": "Street address matched by the Census Geocoder." }, "google_maps_link": { "type": [ "string", "null" ], "description": "Google Maps search link for the matched address." }, "congressional_district": { "type": [ "string", "null" ], "description": "Congressional district label." }, "state_legislative_district_lower": { "type": [ "string", "null" ], "description": "State lower-chamber district name, when available." }, "state_legislative_district_upper": { "type": [ "string", "null" ], "description": "State upper-chamber district name, when available." } }, "additionalProperties": false } ``` ## See more - [House API: Get my representatives](https://fous.com/methods/house.gov/get-my-representatives.md): Finds the current House representative and both senators for a US ZIP code or street address, with office contacts and photos. A ZIP covering several districts returns every possible representative until an address identifies one. - [Zippopotam.us API: Search postal codes](https://fous.com/methods/zippopotam.us/search-postal-codes.md): Finds postal codes, place names and coordinates for a town and state or region in a country covered by Zippopotam.us. - [Walk Score API: Get Walk Score](https://fous.com/methods/walkscore.com/get-walk-score.md): Gets the Walk, Transit and Bike Scores and neighborhood details for a street address. Unpublished scores are null; unresolved or mismatched addresses are not found. - [FEMA API: Get flood zone for an address](https://fous.com/methods/fema.gov/get-flood-zone.md): Finds the FEMA flood zone, risk designation, base flood elevation, flood map panel and community for a US street address, using Census address coordinates and FEMA's National Flood Hazard Layer. - [OpenStreetMap API: Get coordinates for an address](https://fous.com/methods/openstreetmap.org/get-coordinates.md): Finds map coordinates and address details for an address or place on OpenStreetMap, optionally restricted to a country. - [Zippopotam.us API: Get postal code](https://fous.com/methods/zippopotam.us/get-postal-code.md): Looks up the places, regions and coordinates for a postal code in a supported country on Zippopotam.us. - [IPinfo API: Get IP location](https://fous.com/methods/ipinfo.io/get-ip-location.md): Finds the public location and network operator of an IPv4 or IPv6 address. Private and reserved addresses have no public location. - [Postal PIN Code API: Search post offices by place](https://fous.com/methods/postalpincode.in/search-pin-codes.md): Finds Indian post offices matching a place name, with PIN codes, branch types, delivery statuses, districts and states. Optionally narrows by state or district.