Address geocoding API for agents

Address geocoding API for agents: geocode one U.S., Puerto Rico, or U.S. Island Areas address for $0.001 USDC through the public Census Geocoder. Returns approximate coordinates with required Census attribution—no global maps, navigation, or address retention.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://api.delx.ai/api/v1/x402/geocode-us

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "address": "1600 Pennsylvania Ave NW, Washington, DC 20500"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "address": {
              "description": "One U.S., Puerto Rico, or U.S. Island Areas address to geocode.",
              "maxLength": 300,
              "minLength": 1,
              "type": "string"
            },
            "benchmark": {
              "default": "Public_AR_Current",
              "enum": [
                "Public_AR_Current",
                "4"
              ],
              "type": "string"
            },
            "timeout": {
              "default": 8,
              "maximum": 8,
              "minimum": 2,
              "type": "integer"
            }
          },
          "required": [
            "address"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "result": {
            "attribution": "This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.",
            "benchmark": "Public_AR_Current",
            "coverage": "US, Puerto Rico and U.S. Island Areas",
            "data_note": "Coordinates are based on Census address ranges and may be interpolated; this is not a precise rooftop or navigation service.",
            "match_count": 1,
            "matches": [
              {
                "address_components": {
                  "city": "WASHINGTON",
                  "state": "DC",
                  "zip": "20500"
                },
                "coordinates": {
                  "latitude": 38.8977,
                  "longitude": -77.0365
                },
                "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500"
              }
            ],
            "privacy": "Delx does not retain the submitted address or include it in request logs.",
            "provider": "U.S. Census Bureau Geocoder",
            "provider_url": "https://www.census.gov/data/developers/data-sets/Geocoding-services.html",
            "schema": "delx/us-geocode/v1",
            "terms_url": "https://www.census.gov/data/developers/about/terms-of-service.html",
            "upstream_error": false
          },
          "tool_name": "geocode_us_address"
        },
        "type": {
          "const": "json",
          "type": "string"
        }
      },
      "required": [
        "type",
        "example"
      ],
      "type": "object"
    }
  },
  "required": [
    "input",
    "output"
  ],
  "type": "object"
}

This page as JSON