Run US address geocode.

US address geocode returns structured JSON. This example is static; the paid call returns a fresh result and settlement receipt.

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.us-address-geocode",
  "version": "1",
  "data": {
    "query": {
      "address": "4600 Silver Hill Rd, Washington, DC 20233",
      "includeGeographies": true
    },
    "matched": true,
    "matchCount": 1,
    "ambiguous": false,
    "matchesTruncated": false,
    "matches": [
      {
        "matchedAddress": "4600 SILVER HILL RD, WASHINGTON, DC, 20233",
        "coordinates": {
          "longitude": -76.928365658124,
          "latitude": 38.845053106269
        },
        "tigerLine": {
          "id": "657091557",
          "side": "L"
        },
        "addressComponents": {
          "fromAddress": "4600",
          "toAddress": "4700",
          "preQualifier": null,
          "preDirection": null,
          "preType": null,
          "streetName": "SILVER HILL",
          "suffixType": "RD",
          "suffixDirection": null,
          "suffixQualifier": null,
          "city": "WASHINGTON",
          "state": "DC",
          "zip": "20233"
        },
        "geographies": {
          "requested": true,
          "available": true,
          "state": {
            "kind": "state",
            "name": "Maryland",
            "geoid": "24",
            "code": "24",
            "abbreviation": "MD",
            "session": null
          },
          "county": {
            "kind": "county",
            "name": "Prince George's County",
            "geoid": "24033",
            "code": "033",
            "abbreviation": null,
            "session": null
          },
          "tract": {
            "kind": "census_tract",
            "name": "Census Tract 8024.05",
            "geoid": "24033802405",
            "code": "802405",
            "abbreviation": null,
            "session": null
          },
          "block": {
            "kind": "census_block",
            "name": "Block 2004",
            "geoid": "240338024052004",
            "code": "2004",
            "abbreviation": null,
            "session": null
          },
          "congressionalDistrict": {
            "kind": "congressional_district",
            "name": "Congressional District 4",
            "geoid": "2404",
            "code": "4",
            "abbreviation": null,
            "session": "119"
          }
        }
      }
    ],
    "benchmark": {
      "id": "4",
      "name": "Public_AR_Current",
      "description": "Public Address Ranges - Current Benchmark",
      "isDefault": true
    },
    "vintage": {
      "id": "4",
      "name": "Current_Current",
      "description": "Current Vintage - Current Benchmark",
      "isDefault": true
    },
    "source": {
      "provider": "U.S. Census Bureau",
      "dataset": "Census Geocoding Services using MAF/TIGER address ranges",
      "endpointUrl": "https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress",
      "documentationUrl": "https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html",
      "termsUrl": "https://www.census.gov/data/developers/about/terms-of-service.html",
      "attribution": "This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.",
      "transformation": "API Acre selected and normalized bounded address, coordinate, TIGER-line, and requested geography fields without modifying their meaning."
    },
    "retrievedAt": "2026-08-18T05:35:00+00:00",
    "limitations": [
      "Coordinates are calculated along a MAF/TIGER address range; they are not rooftop, parcel-boundary, or entrance coordinates.",
      "Coverage is limited to structural addresses in the United States, Puerto Rico, and U.S. Island Areas.",
      "No match does not prove that an address is nonexistent, current, occupied, or deliverable.",
      "The caller-supplied address is sent to the Census Geocoder only for this lookup; do not use the result to identify or link Census respondents, people, households, businesses, or other entities.",
      "Current benchmark and geography-vintage data can change, and upstream availability is not guaranteed."
    ]
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "data.us-weather-forecast",
        "title": "US weather forecast",
        "reason": "Use the selected Census coordinates for a separately authorized current NWS forecast, with optional current conditions and active point alerts.",
        "method": "POST",
        "path": "/v1/data/us-weather-forecast",
        "price": "$0.003",
        "input_template": {
          "latitude": "$result.data.matches[0].coordinates.latitude",
          "longitude": "$result.data.matches[0].coordinates.longitude",
          "forecast_type": "day_night",
          "units": "us",
          "periods": 6,
          "include_current_conditions": true,
          "include_active_alerts": true
        },
        "use_output": "Run only after confirming the intended address match. Census coordinates are address-range estimates and NWS point coverage may map them to a nearby forecast grid.",
        "handoff_path": "/catalog/data.us-weather-forecast",
        "checkout_path": "/try/data.us-weather-forecast",
        "sample_path": "/samples/data.us-weather-forecast",
        "maximum_atomic_usdc": "3000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      }
    ]
  }
}