{
  "name": "BOMAtlas public API",
  "description": "Read-only JSON over US higher education (IPEDS 2024-25), France education authorities, and federally registered US suppliers (SAM.gov).",
  "documentation": "https://bomatlas.com/llms.txt",
  "auth": "none (public, rate-limited)",
  "contact": "tom@bomforge.com",
  "endpoints": [
    {
      "path": "/api/institutions",
      "description": "Education institutions. Defaults to the US IPEDS community-college layer; use country=FR for the official France directory.",
      "params": {
        "country": "ISO-3166 alpha-2; US default, FR available",
        "segment": "community_college | public_university | private_college | secondary_school | middle_school | primary_school | other",
        "q": "name or city search",
        "state": "state or official region label",
        "admin1": "ISO-3166-2 region code, such as FR-IDF",
        "limit": "page size; FR default 500",
        "offset": "pagination offset"
      },
      "fields": "id, n name, c city, s state/region, lat, lon, w website, co country, seg segment, ct coverage tier, xid authority ID"
    },
    {
      "path": "/api/schools",
      "description": "Career and trade schools. Roughly half the cohort is non-industrial; use ?domain to scope.",
      "params": {
        "domain": "industrial | personal_services | health | business_tech | public_academic",
        "state": "two-letter state code",
        "bounds": "swLat,swLon,neLat,neLon",
        "country": "ISO-3166 alpha-2, default US (\"all\" disables)"
      },
      "fields": "id, n name, c city, s state, lat, lon, w website, p source programs, d domain, pf canonical program families"
    },
    {
      "path": "/api/campus-suppliers",
      "description": "Registered suppliers near a campus. Geocoding is city-centroid.",
      "params": {
        "id": "IPEDS UNITID",
        "radius": "25 | 50 (miles)",
        "q": "name filter"
      }
    },
    {
      "path": "/api/companies/map",
      "description": "Registered suppliers with coordinates, for map rendering.",
      "params": {
        "state": "two-letter state code",
        "bounds": "swLat,swLon,neLat,neLon"
      }
    },
    {
      "path": "/api/cage/{code}",
      "description": "Resolve a CAGE code to a registered entity."
    },
    {
      "path": "/api/stats",
      "description": "Coverage counts by dataset."
    },
    {
      "path": "/api/health",
      "description": "Service health."
    }
  ],
  "provenance": {
    "institutions": "US: IPEDS HD2024, US Department of Education. France: Annuaire de l’Education nationale with MESR higher-education overlays.",
    "suppliers": "SAM.gov entity registrations",
    "overviews": "Model-generated from directory fields and validated against them; labeled as overviews on the page."
  },
  "limits": [
    "Supplier registration proves a SAM.gov record, not capability or capacity.",
    "Supplier-to-campus distance is approximate (city-centroid geocoding).",
    "France education rows are official directory records, not verified procurement opportunities or supplier-registration channels.",
    "cosmetology/barbering/esthetics/culinary families are name-inferred where the source records only a combined category."
  ]
}