{
  "format": "delx/intent-card/v1",
  "id": "us-address-geocoding-api",
  "intent": "geocode a US address into approximate coordinates",
  "title": "US address geocoding API for agents",
  "description": "Geocode one U.S., Puerto Rico, or U.S. Island Areas address for $0.001 through the public Census Geocoder, with required attribution and no address retention.",
  "keywords": [
    "address geocoding API",
    "US geocoding API",
    "Census Geocoder",
    "address to coordinates",
    "maps API for agents",
    "x402 geocoding"
  ],
  "updated_at": "2026-08-01",
  "canonical_url": "https://commerce.delx.ai/intents/us-address-geocoding-api",
  "machine_url": "https://commerce.delx.ai/intents/us-address-geocoding-api.json",
  "recommendation": {
    "tool_name": "geocode_us_address",
    "service_name": "Delx US Geocode",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/geocode-us",
    "price_usdc": "0.001",
    "payment_protocols": [
      "x402",
      "mpp"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300,
          "description": "One U.S., Puerto Rico, or U.S. Island Areas address."
        },
        "benchmark": {
          "type": "string",
          "enum": [
            "Public_AR_Current",
            "4"
          ],
          "default": "Public_AR_Current"
        },
        "timeout": {
          "type": "integer",
          "minimum": 2,
          "maximum": 8,
          "default": 8
        }
      },
      "required": [
        "address"
      ],
      "additionalProperties": false
    },
    "example_input": {
      "address": "1600 Pennsylvania Ave NW, Washington, DC 20500"
    },
    "example_output": {
      "tool_name": "geocode_us_address",
      "result": {
        "schema": "delx/us-geocode/v1",
        "coverage": "US, Puerto Rico and U.S. Island Areas",
        "match_count": 1,
        "matches": [
          {
            "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
            "coordinates": {
              "longitude": -77.0365,
              "latitude": 38.8977
            },
            "address_components": {
              "city": "WASHINGTON",
              "state": "DC",
              "zip": "20500"
            }
          }
        ],
        "benchmark": "Public_AR_Current",
        "provider": "U.S. Census Bureau Geocoder",
        "provider_url": "https://www.census.gov/data/developers/data-sets/Geocoding-services.html",
        "terms_url": "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.",
        "data_note": "Coordinates are based on Census address ranges and may be interpolated; this is not a precise rooftop or navigation service.",
        "privacy": "Delx does not retain the submitted address or include it in request logs.",
        "upstream_error": false
      }
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/geocode-us -m POST -H 'x-delx-source: intent-card-us-address-geocoding-api' --max-amount 0.001 -b '{\"address\":\"1600 Pennsylvania Ave NW, Washington, DC 20500\"}'",
      "max_amount_usdc": "0.001"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-us-address-geocoding-api"
  },
  "evidence": {
    "paid_openapi": "https://api.delx.ai/openapi.x402.json",
    "governed_portfolio": "https://api.delx.ai/x402-portfolio.json",
    "live_contract": "https://api.delx.ai/api/v1/x402/geocode-us"
  }
}