{"uid":"cap_9dzLuRWgMUlTAymuw01-y","slug":"2s-io-gov-district-lookup-e6a0ddc9","name":"2s.io Gov District Lookup","description":"Resolve a US street address to its congressional district (119th Congress), state, and county, via the US Census Bureau geocoder. Returns the matched/normalized address, latitude/longitude, state (name + 2-letter abbreviation), county, and the district number within the state (null for at-large or non-voting delegate districts). The point-in-polygon district lookup is something an agent can't do from a sandbox. Pair it with the gov/congress.* endpoints to find the representatives once you have the state + district. Public domain, keyless.","url":"https://2s.io/api/gov/district","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["address"],"properties":{"address":{"type":"string","description":"A US street address (one line)."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"address":"1600 Pennsylvania Avenue NW, Washington, DC 20500"}}},"response":{"data":{"ok":true,"meta":{"source":"census"},"items":[{"state":"District of Columbia","county":"District of Columbia","congress":"119th","district":"98","stateAbbr":"DC","stateFips":"11","coordinates":{"lat":38.89869893252,"lon":-77.03518753691},"districtName":"Delegate District (at Large)","matchedAddress":"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500"}],"total":1,"source":{"url":"https://geocoding.geo.census.gov","license":"US Census Bureau geocoder — public domain (US Government work).","provider":"US Census Bureau Geocoder"}},"meta":{"cost":{"usd":0.0018,"tier":0},"caller":"x402","version":null,"endpoint":"gov.district","settlement":{"txHash":"0xe1e5bfb29dba1aafeff6efc177e550960aca41a1176c6261605e3d64055bbcc8","network":"eip155:8453","success":true}}}},"exampleRequest":{"address":"1600 Pennsylvania Avenue NW, Washington, DC 20500"},"tags":["x402"],"displayCostAmount":"0.0018","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0018/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sDpF5gskIKwwwnNoEzWYZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0045","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the congressional district, county, state, and geocoordinates for a given US street address using US Census Bureau data.","exampleAgentPrompt":"What congressional district is 1600 Pennsylvania Ave NW, Washington, DC 20500 in? I need the district name, state, and county too.","exampleUseCases":null,"resultDescription":"Returns a JSON object with ok status, a list of matched items each containing the state name and abbreviation, county, congressional district number, district name, FIPS code, geocoordinates (lat/lon), and matched address string — sourced from the US Census Bureau Geocoder under public domain license.","failureModes":["Address not found or unrecognized: returns empty items array with total 0","Non-US address provided: likely returns no match","Malformed address string: Census geocoder may fail to match","Payment failure (402): USDC payment of $0.0018 required before response is returned","Rate or network errors from upstream Census Bureau geocoder"],"whenToPreferThis":"Use this endpoint when you need authoritative, Census Bureau-sourced congressional district and geocoding data for a US address — especially when you need the district name, FIPS code, and coordinates together in one call. Prefer this over general geocoding APIs when the political/governmental district classification is the primary requirement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:04:53.722Z","isFirstParty":false}