{
  "id": "postal-facilities",
  "name": "Postal Facilities",
  "description": "U.S. postal facilities, ZIP geography, address metadata, crosswalks, and historical post offices.",
  "kind": "api",
  "audience": "public",
  "access": "open",
  "auth": "Public datasets require no authentication; licensed CMRA data is not exposed in this catalog.",
  "lifecycle": "active",
  "health": "degraded",
  "canonicalUrl": "https://postalfacilities.datasourceapi.com",
  "aliases": [],
  "docsUrl": "https://postalfacilities.datasourceapi.com/api/v1/docs",
  "docsMediaType": "text/html",
  "openapiUrl": "https://postalfacilities.datasourceapi.com/api/v1/openapi.yaml",
  "openapiMediaType": "application/yaml",
  "statusUrl": "https://postalfacilities.datasourceapi.com/api/v1/status",
  "statusMediaType": "application/json",
  "repository": "https://github.com/coopalliance/cca-postalfacilities",
  "serviceBinding": {
    "supported": true,
    "description": "Approved fleet Workers can use public metadata through a service binding; licensed datasets remain private."
  },
  "provenance": [
    {
      "name": "United States Postal Service",
      "description": "PostalPro, Locations, and public address-related datasets.",
      "url": "https://postalpro.usps.com/"
    },
    {
      "name": "HUD-USPS ZIP crosswalk",
      "description": "Quarterly ZIP Code crosswalk data.",
      "url": "https://www.huduser.gov/portal/datasets/usps_crosswalk.html"
    }
  ],
  "freshness": {
    "cadence": "Daily release detection with a 30-minute automation poller.",
    "lastVerified": "2026-09-03"
  },
  "capabilities": [
    "addresses",
    "postal-facilities",
    "postal-history",
    "zip-crosswalks"
  ],
  "examples": [
    {
      "label": "Service status",
      "description": "Inspect current source releases and freshness.",
      "method": "GET",
      "url": "https://postalfacilities.datasourceapi.com/api/v1/status"
    }
  ],
  "operations": [
    {
      "operationId": "getPostalFacilitiesStatus",
      "summary": "Get postal source freshness and service health.",
      "method": "GET",
      "path": "/api/v1/status"
    }
  ],
  "agentReadiness": {
    "level": "partial",
    "score": 64,
    "summary": "OpenAPI and docs are available; several source datasets were stale at the last audit."
  }
}