{
 "version": "v1",
 "site": "https://egid-ewid.ch",
 "outils": [
  {
   "name": "search_building",
   "description": "Trouve le bâtiment suisse (EGID) d'une adresse, dans les 26 cantons. Rend rue, numéro, NPA, localité, commune, canton, année, étages, nombre de logements et statut. Si l'adresse n'existe pas, dit pourquoi (rue inconnue, numéro absent — avec les numéros existants).",
   "inputSchema": {
    "type": "object",
    "required": [
     "q"
    ],
    "properties": {
     "q": {
      "type": "string",
      "description": "adresse, ex. « Bahnhofstrasse 1, 8001 Zürich » ou « 116 route de Frontenex, Genève » (les deux ordres)"
     }
    }
   },
   "appel": {
    "transport": "http",
    "methode": "GET",
    "url": "https://egid-ewid.ch/api/v1/recherche",
    "parametres": [
     "q"
    ]
   },
   "exemple": "https://egid-ewid.ch/api/v1/recherche?q=Bahnhofstrasse%201%2C%20Z%C3%BCrich",
   "url": "https://egid-ewid.ch/api/v1/recherche",
   "statut": "servi",
   "annotations": {
    "readOnlyHint": true
   }
  },
  {
   "name": "get_building",
   "description": "Fiche d'un bâtiment par son EGID, avec la liste de ses logements (EWID, étage, surface, pièces) et ses adresses.",
   "inputSchema": {
    "type": "object",
    "required": [
     "egid"
    ],
    "properties": {
     "egid": {
      "type": "integer",
      "description": "identifiant fédéral du bâtiment, 1 à 9 chiffres"
     }
    }
   },
   "appel": {
    "transport": "http",
    "methode": "GET",
    "url": "https://egid-ewid.ch/api/v1/recherche",
    "parametres": [
     "egid"
    ]
   },
   "exemple": "https://egid-ewid.ch/api/v1/recherche?egid=302030417",
   "url": "https://egid-ewid.ch/api/v1/recherche",
   "statut": "servi",
   "annotations": {
    "readOnlyHint": true
   }
  },
  {
   "name": "describe_dataset",
   "description": "Couverture, source, licence, champs.",
   "url": "https://egid-ewid.ch/api/v1/manifest.json",
   "statut": "servi",
   "inputSchema": {
    "type": "object",
    "properties": {}
   },
   "annotations": {
    "readOnlyHint": true
   }
  },
  {
   "name": "get_schema",
   "description": "Champs et taux de remplissage mesurés.",
   "url": "https://egid-ewid.ch/api/v1/champs.json",
   "statut": "servi",
   "inputSchema": {
    "type": "object",
    "properties": {}
   },
   "annotations": {
    "readOnlyHint": true
   }
  },
  {
   "name": "get_sample",
   "description": "Échantillon gratuit de bâtiments réels.",
   "url": "https://egid-ewid.ch/api/v1/echantillon.json",
   "statut": "servi",
   "inputSchema": {
    "type": "object",
    "properties": {}
   },
   "annotations": {
    "readOnlyHint": true
   }
  },
  {
   "name": "changes_since",
   "description": "Différentiel daté du registre fédéral entre deux extractions : bâtiments entrés, sortis, changements de statut et de logements.",
   "url": "https://egid-ewid.ch/api/v1/changements.json",
   "statut": "servi",
   "inputSchema": {
    "type": "object",
    "properties": {}
   },
   "annotations": {
    "readOnlyHint": true
   }
  },
  {
   "name": "request_bulk_lookup",
   "description": "Prépare une demande de traitement d'une liste d'adresses (EGID/EWID en masse). L'agent remplit le formulaire ; l'humain l'envoie. Aucun paiement en ligne.",
   "inputSchema": {
    "type": "object",
    "required": [
     "email"
    ],
    "properties": {
     "email": {
      "type": "string"
     },
     "liste": {
      "type": "string",
      "description": "fichier CSV ou Excel (champ `liste`)"
     }
    }
   },
   "appel": {
    "transport": "formulaire",
    "methode": "POST",
    "page": "https://egid-ewid.ch/acces-pro",
    "note": "formulaire annoté toolname=request_bulk_lookup ; envoi par l'humain"
   },
   "url": "https://egid-ewid.ch/acces-pro",
   "statut": "servi",
   "annotations": {
    "readOnlyHint": false,
    "consequentialHint": true
   }
  },
  {
   "name": "order_building_report",
   "description": "Prépare la commande d'un rapport daté (CHF 19) sur un bâtiment : EGID, adresses, EWID de chaque logement, sources. L'agent remplit, la personne envoie ; aucun paiement en ligne.",
   "inputSchema": {
    "type": "object",
    "required": [
     "batiment",
     "email"
    ],
    "properties": {
     "batiment": {
      "type": "string",
      "description": "adresse ou EGID"
     },
     "email": {
      "type": "string"
     },
     "usage": {
      "type": "string"
     }
    }
   },
   "appel": {
    "transport": "formulaire",
    "methode": "POST",
    "page": "https://egid-ewid.ch/rapport",
    "note": "formulaire annoté toolname=order_building_report ; consentement requis"
   },
   "url": "https://egid-ewid.ch/rapport",
   "statut": "servi",
   "annotations": {
    "readOnlyHint": false,
    "consequentialHint": true
   }
  },
  {
   "name": "export_dataset",
   "description": "Jeu complet normalisé, sur devis.",
   "url": "https://egid-ewid.ch/donnees",
   "statut": "reserve",
   "inputSchema": {
    "type": "object",
    "properties": {}
   },
   "annotations": {
    "readOnlyHint": true
   }
  }
 ],
 "limites": "Usage unitaire, sans clé. Pour une liste, le traitement en masse se demande sur /acces-pro.",
 "avertissement": "Ni propriétaire, ni servitude : voir le registre foncier."
}