{
 "route": "geo-reverse",
 "title": "Reverse geocode to Census geographies",
 "method": "GET",
 "price_usdc": 0.003,
 "amount_atomic": "3000",
 "request": {
  "method": "GET",
  "url": "https://utility.agentexchange.work/v1/geo/reverse?lat=30.2672&lon=-97.7431",
  "headers": {
   "PAYMENT-SIGNATURE": "<base64 x402 v2 payment payload> (or X-PAYMENT for v1)"
  }
 },
 "captured_at": "2026-10-01T00:24:56.113Z",
 "captured_from": "live upstream, on first request; refreshed after 24 h",
 "response_200": {
  "lat": 30.2672,
  "lon": -97.7431,
  "in_us": true,
  "geographies": {
   "state": {
    "fips": "48",
    "abbr": "TX",
    "name": "Texas"
   },
   "county": {
    "fips": "48453",
    "county_fips": "453",
    "name": "Travis County"
   },
   "tract": {
    "geoid": "48453001103",
    "tract": "001103",
    "name": "Census Tract 11.03"
   },
   "block_group": {
    "geoid": "484530011032",
    "block_group": "2"
   },
   "block": {
    "geoid": "484530011032007",
    "block": "2007",
    "layer": "2020 Census Blocks"
   },
   "place": {
    "geoid": "4805000",
    "name": "Austin city"
   },
   "county_subdivision": {
    "geoid": "4845390165",
    "name": "Austin CCD"
   },
   "congressional_district": {
    "geoid": "4810",
    "name": "Congressional District 10",
    "layer": "120th Congressional Districts"
   },
   "zcta": {
    "zcta5": "78701"
   },
   "metro_area": {
    "cbsa": "12420",
    "name": "Austin-Round Rock-San Marcos, TX Metro Area"
   },
   "school_district": {
    "geoid": "4808940",
    "name": "Austin Independent School District"
   }
  },
  "source": {
   "provider": "US Census Bureau Geocoder (geocoding.geo.census.gov)",
   "url": "https://geocoding.geo.census.gov/geocoder/geographies/coordinates?x=-97.7431&y=30.2672&benchmark=Public_AR_Current&vintage=Current_Current&layers=all&format=json",
   "license": "public (US Government work); benchmark Public_AR_Current, vintage Current_Current"
  },
  "fetched_at": "2026-10-01T00:24:56.108Z",
  "route": "geo-reverse",
  "price_usdc": 0.003,
  "payment": {
   "transaction": "0x… (settlement transaction hash)",
   "network": "eip155:8453",
   "payer": "0x… (payer address)"
  },
  "request_id": "…"
 },
 "response_402_without_payment": {
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
   "url": "https://utility.agentexchange.work/v1/geo/reverse?lat=30.2672&lon=-97.7431",
   "description": "Maps a lat/lon to US Census geographies with the US Census Bureau Geocoder: state and county FIPS, tract, block group, block, place, county subdivision, congressional district, ZCTA, metro area and school district. Call it when an agent has coordinates and needs the US county, FIPS codes or census tract. Points outside the US answer in_us:false (a valid, charged result).",
   "mimeType": "application/json",
   "serviceName": "US lat/lon to county and tract",
   "tags": [
    "geocoding",
    "reverse",
    "census",
    "fips",
    "geo"
   ],
   "iconUrl": "https://utility.agentexchange.work/icon.png"
  },
  "accepts": [
   {
    "scheme": "exact",
    "network": "eip155:8453",
    "amount": "3000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0xc91cE6291eDC0713ec753BAFBA002506ffb2b95c",
    "maxTimeoutSeconds": 300,
    "extra": {
     "name": "USD Coin",
     "version": "2"
    }
   }
  ],
  "extensions": {
   "bazaar": {
    "info": {
     "input": {
      "type": "http",
      "method": "GET",
      "queryParams": {
       "lat": "30.2672",
       "lon": "-97.7431"
      }
     },
     "output": {
      "type": "json",
      "example": {
       "lat": 30.2672,
       "lon": -97.7431,
       "in_us": true,
       "geographies": {
        "state": {
         "fips": "48",
         "abbr": "TX",
         "name": "Texas"
        },
        "county": {
         "fips": "48453",
         "county_fips": "453",
         "name": "Travis County"
        },
        "tract": {
         "geoid": "48453001103",
         "tract": "001103",
         "name": "Census Tract 11.03"
        },
        "block_group": {
         "geoid": "484530011032",
         "block_group": "2"
        },
        "block": {
         "geoid": "484530011032007",
         "block": "2007",
         "layer": "2020 Census Blocks"
        },
        "place": {
         "geoid": "4805000",
         "name": "Austin city"
        },
        "county_subdivision": {
         "geoid": "4845390165",
         "name": "Austin CCD"
        },
        "congressional_district": {
         "geoid": "4810",
         "name": "Congressional District 10",
         "layer": "120th Congressional Districts"
        },
        "zcta": {
         "zcta5": "78701"
        },
        "metro_area": {
         "cbsa": "12420",
         "name": "Austin-Round Rock-San Marcos, TX Metro Area"
        },
        "school_district": {
         "geoid": "4808940",
         "name": "Austin Independent School District"
        }
       },
       "source": {
        "provider": "US Census Bureau Geocoder (geocoding.geo.census.gov)",
        "url": "https://geocoding.geo.census.gov/geocoder/geographies/coordinates?x=-97.7431&y=30.2672&benchmark=Public_AR_Current&vintage=Current_Current&layers=all&format=json",
        "license": "public (US Government work); benchmark Public_AR_Current, vintage Current_Current"
       },
       "fetched_at": "2026-10-01T00:12:05.851Z"
      }
     }
    },
    "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "type": "object",
     "properties": {
      "input": {
       "type": "object",
       "properties": {
        "type": {
         "type": "string",
         "const": "http"
        },
        "method": {
         "type": "string",
         "enum": [
          "GET",
          "HEAD"
         ]
        },
        "queryParams": {
         "type": "object",
         "properties": {
          "lat": {
           "type": "number",
           "minimum": -90,
           "maximum": 90,
           "description": "latitude in decimal degrees (WGS84)"
          },
          "lon": {
           "type": "number",
           "minimum": -180,
           "maximum": 180,
           "description": "longitude in decimal degrees (WGS84)"
          }
         },
         "required": [
          "lat",
          "lon"
         ]
        }
       },
       "required": [
        "type",
        "method"
       ],
       "additionalProperties": false
      },
      "output": {
       "type": "object",
       "properties": {
        "type": {
         "type": "string"
        },
        "example": {
         "type": "object",
         "properties": {
          "lat": {
           "type": "number"
          },
          "lon": {
           "type": "number"
          },
          "in_us": {
           "type": "boolean"
          },
          "geographies": {
           "type": "object",
           "properties": {
            "state": {
             "type": "object",
             "properties": {
              "fips": {
               "type": "string"
              },
              "abbr": {
               "type": "string"
              },
              "name": {
               "type": "string"
              }
             }
            },
            "county": {
             "type": "object",
             "properties": {
              "fips": {
               "type": "string"
              },
              "county_fips": {
               "type": "string"
              },
              "name": {
               "type": "string"
              }
             }
            },
            "tract": {
             "type": "object",
             "properties": {
              "geoid": {
               "type": "string"
              },
              "tract": {
               "type": "string"
              },
              "name": {
               "type": "string"
              }
             }
            },
            "block_group": {
             "type": "object",
             "properties": {
              "geoid": {
               "type": "string"
              },
              "block_group": {
               "type": "string"
              }
             }
            },
            "block": {
             "type": "object",
             "properties": {
              "geoid": {
               "type": "string"
              },
              "block": {
               "type": "string"
              },
              "layer": {
               "type": "string"
              }
             }
            },
            "place": {
             "type": "object",
             "properties": {
              "geoid": {
               "type": "string"
              },
              "name": {
               "type": "string"
              }
             }
            },
            "county_subdivision": {
             "type": "object",
             "properties": {
              "geoid": {
               "type": "string"
              },
              "name": {
               "type": "string"
              }
             }
            },
            "congressional_district": {
             "type": "object",
             "properties": {
              "geoid": {
               "type": "string"
              },
              "name": {
               "type": "string"
              },
              "layer": {
               "type": "string"
              }
             }
            },
            "zcta": {
             "type": "object",
             "properties": {
              "zcta5": {
               "type": "string"
              }
             }
            },
            "metro_area": {
             "type": "object",
             "properties": {
              "cbsa": {
               "type": "string"
              },
              "name": {
               "type": "string"
              }
             }
            },
            "school_district": {
             "type": "object",
             "properties": {
              "geoid": {
               "type": "string"
              },
              "name": {
               "type": "string"
              }
             }
            }
           }
          },
          "source": {
           "type": "object",
           "properties": {
            "provider": {
             "type": "string"
            },
            "url": {
             "type": "string"
            },
            "license": {
             "type": "string"
            }
           }
          },
          "fetched_at": {
           "type": "string"
          }
         }
        }
       },
       "required": [
        "type"
       ]
      }
     },
     "required": [
      "input"
     ]
    }
   }
  },
  "message": "Pay $0.003 USDC on Base and retry with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).",
  "price": "$0.003",
  "price_usdc": 0.003,
  "amount_atomic": "3000",
  "input_example": "https://utility.agentexchange.work/v1/geo/reverse?lat=30.2672&lon=-97.7431",
  "docs": {
   "openapi": "https://utility.agentexchange.work/openapi.json",
   "llms": "https://utility.agentexchange.work/llms.txt",
   "sample": "https://utility.agentexchange.work/samples/geo-reverse.json",
   "terms": "https://utility.agentexchange.work/terms"
  }
 },
 "docs": "https://utility.agentexchange.work/llms.txt"
}