{"openapi":"3.1.0","info":{"title":"synergieloc — API immobilière pour les IA","version":"1.0.0","description":"Calculs immobiliers français réglementaires exacts (loi 89-462, décret 87-713) : révision IRL, régularisation de charges, quittances et courriers conformes. Clé API : https://synergieloc.fr/api-ia — Serveur MCP : https://synergieloc.fr/mcp","contact":{"email":"contact@synergieloc.fr","url":"https://synergieloc.fr/api-ia"}},"servers":[{"url":"https://synergieloc.fr"}],"paths":{"/api/v1/me":{"get":{"tags":["api-ia"],"summary":"Api V1 Me","description":"Infos de la clé : plan, quota, unités consommées ce mois.","operationId":"api_v1_me_api_v1_me_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/irl/revision":{"post":{"tags":["api-ia"],"summary":"Api V1 Irl Revision","description":"Révision annuelle de loyer indexée IRL (art. 17-1 loi 89-462).\nBody : {loyer_actuel, irl_reference, irl_nouveau, [charges_actuelles]}.\nL'appelant fournit les indices INSEE (T de référence du bail et nouveau T).","operationId":"api_v1_irl_revision_api_v1_irl_revision_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/regularisation/charges":{"post":{"tags":["api-ia"],"summary":"Api V1 Regul Charges","description":"Régularisation annuelle des charges locatives (décret 87-713).\nBody : {provisions_encaissees, tantiemes_locataire, tantiemes_total,\n        charges: [{libelle, montant, recuperable(bool, def=true)}],\n        [jours_occupation, jours_periode=365]}.","operationId":"api_v1_regul_charges_api_v1_regularisation_charges_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/documents/quittance":{"post":{"tags":["api-ia"],"summary":"Api V1 Quittance","description":"Quittance de loyer conforme (art. 21 loi 89-462), PDF (défaut) ou HTML.\nBody : {bailleur_nom, bailleur_adresse, locataire_nom, logement_adresse,\n        periode, loyer, charges, date_paiement, [lieu, date_emission, format:'pdf'|'html']}.","operationId":"api_v1_quittance_api_v1_documents_quittance_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/documents/avenant-irl":{"post":{"tags":["api-ia"],"summary":"Api V1 Avenant Irl","description":"Courrier de révision de loyer IRL prêt à envoyer (PDF, ou format:'html').\nBody : {bailleur_nom, locataire_nom, logement_adresse, loyer_actuel,\n        irl_reference, irl_nouveau, date_effet,\n        [bailleur_adresse, trimestre_reference, trimestre_nouveau, lieu, date_emission]}.","operationId":"api_v1_avenant_irl_api_v1_documents_avenant_irl_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"security":[{"ApiKeyAuth":[]}]}