{
  "schema": "kallipolis.resource-quality.v1",
  "id": "resource.public-data.census-geocoder-api",
  "version": "1.0.0",
  "title": "U.S. Census Geocoder API boundary",
  "summary": "Official-source access, authentication, request-shaping, paging, freshness, legal, and interpretation boundaries for U.S. Census Geocoder API.",
  "content": {
    "kind": "public-data-api-boundary",
    "facts": [
      {
        "id": "fact.census.geocoder-api.access",
        "statement": "The Census Geocoder converts structured U.S., Puerto Rico, and Island Area addresses or coordinates into calculated locations and optional Census geographic-area matches through single and batch services.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.census.geocoder-api"
        ]
      },
      {
        "id": "fact.census.geocoder-api.authentication",
        "statement": "The public service does not require an API key and does not provide access to confidential Census records, address ownership, identity verification, or source-database mutation.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.census.geocoder-api"
        ]
      },
      {
        "id": "fact.census.geocoder-api.request",
        "statement": "Clients must bind return and search types, address or coordinate input, benchmark, vintage, layers, and JSON or JSONP format; batch files are limited to ten thousand records.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.census.geocoder-api"
        ]
      },
      {
        "id": "fact.census.geocoder-api.boundary",
        "statement": "A geocode is calculated from the selected MAF/TIGER benchmark and may be unmatched, approximate, or vintage-dependent; it does not prove occupancy, deliverability, jurisdiction, identity, or current ground truth.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.census.geocoder-api"
        ]
      }
    ]
  },
  "language": "en",
  "category": "public-data-api",
  "state": "prepared",
  "canonicalUrl": "https://platoskallipolis.com/resources/public-data-apis/census-geocoder-api.json",
  "contentHash": "sha256:d6172a58a88fe30f52255e44669b0b49dc81dbb5f55d534d72f2402b622ae23b",
  "owner": {
    "id": "platos-kallipolis",
    "name": "Plato's Kallipolis",
    "type": "organization",
    "accountabilityUrl": "https://platoskallipolis.com/about"
  },
  "access": {
    "mode": "public",
    "url": "https://platoskallipolis.com/resources/public-data-apis/census-geocoder-api.json",
    "authentication": "none",
    "robotsAllowed": true
  },
  "provenance": {
    "method": "primary-source",
    "sources": [
      {
        "id": "source.census.geocoder-api",
        "url": "https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html",
        "title": "Geocoding Services API",
        "publisher": "U.S. Census Bureau",
        "observedAt": "2026-08-28T05:32:38Z"
      }
    ]
  },
  "observedAt": "2026-08-28T05:32:38Z",
  "freshness": {
    "policy": "max-age",
    "state": "current",
    "nextReviewAt": "2026-09-04T05:32:38Z",
    "maxAgeSeconds": 604800
  },
  "license": {
    "id": "source-terms-apply",
    "url": "https://www.census.gov/about/policies/quality.html",
    "redistributionAllowed": false
  },
  "evidence": [
    {
      "id": "evidence.census.geocoder-api",
      "type": "source-claim",
      "url": "https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html",
      "observedAt": "2026-08-28T05:32:38Z"
    }
  ]
}