API REST et webhooks signés.

Immeubles

Copropriétés dont le cabinet est syndic et immeubles gérés en location. entite_id désigne la comptabilité du syndicat.

• GET /immeubles Liste
• GET /immeubles/{id} Un immeuble

curl "https://gerelio.com/api/v1/immeubles?limite=1" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": [
    {
      "id": "119be282-fe81-4a6d-b6a1-32c3356495d9",
      "nom": "Le Clos Saint-Martin",
      "adresse": "3 chemin Saint-Martin",
      "code_postal": "69300",
      "ville": "Caluire-et-Cuire",
      "annee_construction": 1998,
      "gere_en_syndic": true,
      "rnic_numero": "AC7-455-102",
      "exercice_debut_mois": 1,
      "entite_id": "c428fca7-2b7c-46d4-83ba-73a855b5a20d",
      "nombre_lots": 12,
      "cree_le": "2026-09-26T11:37:35.877+00:00"
    }
  ],
  "a_suivre": true,
  "curseur_suivant": "MjAyNi0wOS0yNlQxMTozNzozNS44NzcwMDBafDExOWJlMjgyLWZlODEtNGE2ZC1iNmExLTMyYzMzNTY0OTVkOQ"
}

Lots

Lots avec leurs tantièmes par clé de répartition (CG : charges générales, base des voix en assemblée).

• GET /lots Liste
• GET /lots/{id} Un lot

curl "https://gerelio.com/api/v1/lots?immeuble_id=119be282-fe81-4a6d-b6a1-32c3356495d9&limite=1" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": [
    {
      "id": "00dbe1f0-e25a-4d1b-a0dc-02b1a1975145",
      "immeuble_id": "119be282-fe81-4a6d-b6a1-32c3356495d9",
      "numero": "B05",
      "type": "appartement",
      "etage": "1er",
      "surface_m2": 90,
      "pieces": 4,
      "proprietaire_id": "c2d23cd8-c71b-47c1-8d50-122d5d09a062",
      "dpe_classe": "D",
      "dpe_date": null,
      "tantiemes": {
        "CG": 900
      },
      "cree_le": "2026-09-26T11:37:35.877+00:00"
    }
  ],
  "a_suivre": true,
  "curseur_suivant": "MjAyNi0wOS0yNlQxMTozNzozNS44NzcwMDBafDAwZGJlMWYwLWUyNWEtNGQxYi1hMGRjLTAyYjFhMTk3NTE0NQ"
}

Personnes

Copropriétaires, propriétaires bailleurs, locataires et fournisseurs. Les rôles sont déduits des données (lots, mandats, baux actifs). L’IBAN n’est jamais renvoyé en entier : seuls ses quatre premiers et quatre derniers caractères le sont.

• GET /personnes Liste
• GET /personnes/{id} Une personne
• POST /personnes Créer (voir Écriture)
• PATCH /personnes/{id} Modifier (voir Écriture)

curl "https://gerelio.com/api/v1/personnes?role=coproprietaire&limite=1" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": [
    {
      "id": "06c6bc6c-8885-436e-b1f2-db6e7da9f81b",
      "type": "physique",
      "civilite": "Mme",
      "nom": "Michel",
      "prenom": "Nathalie",
      "raison_sociale": null,
      "nom_affiche": "Mme Nathalie Michel",
      "email": "nathalie.michel1@exemple.fr",
      "telephone": "06 37 53 71 89",
      "adresse": "18 rue de la République",
      "code_postal": "69006",
      "ville": "Lyon",
      "siren": null,
      "iban_masque": null,
      "est_fournisseur": false,
      "metier": null,
      "notification_papier_demandee": false,
      "roles": [
        "coproprietaire"
      ],
      "cree_le": "2026-09-26T11:37:35.877+00:00"
    }
  ],
  "a_suivre": true,
  "curseur_suivant": "MjAyNi0wOS0yNlQxMTozNzozNS44NzcwMDBafDA2YzZiYzZjLTg4ODUtNDM2ZS1iMWYyLWRiNmU3ZGE5ZjgxYg"
}

Baux

Baux de la gestion locative, avec le bailleur (via le mandat de gestion) et l’état de la dernière signature électronique.

• GET /baux Liste
• GET /baux/{id} Un bail

curl "https://gerelio.com/api/v1/baux?statut=actif&limite=1" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": [
    {
      "id": "04170fa2-f189-4919-848d-c9e8528a8717",
      "lot_id": "b5d5e3a4-ca66-45e6-a0bb-c67f093a2335",
      "immeuble_id": "ae41ac0e-8b82-4bcd-b09c-eb03ac98a0c4",
      "mandat_gestion_id": "08367097-6f75-4e68-9bef-169c5982cee3",
      "bailleur_id": "a8ee9d90-57e4-476e-ba76-5fce2650dbd7",
      "locataire_id": "dc25aa35-77ae-432a-8d05-757ee4fa5cbe",
      "type": "vide",
      "date_debut": "2024-04-24",
      "duree_mois": 36,
      "date_fin": null,
      "loyer_hc_cents": 94000,
      "provisions_charges_cents": 9000,
      "depot_garantie_cents": 94000,
      "irl_reference": "2024-T2",
      "revision_mois": 4,
      "statut": "actif",
      "signature": null,
      "cree_le": "2026-09-26T11:37:35.877+00:00"
    }
  ],
  "a_suivre": true,
  "curseur_suivant": "MjAyNi0wOS0yNlQxMTozNzozNS44NzcwMDBafDA0MTcwZmEyLWYxODktNDkxOS04NDhkLWM5ZTg1MjhhODcxNw"
}

Entités, écritures et balance

Chaque syndicat de copropriétaires et la gérance ont leur propre comptabilité (entité). Les écritures sont scellées : hash chaîne chaque écriture à la précédente.

• GET /entites Entités comptables
• GET /entites/{id} Une entité
• GET /entites/{id}/balance Balance des comptes
• GET /ecritures Écritures avec leurs lignes
• GET /ecritures/{id} Une écriture

curl "https://gerelio.com/api/v1/entites/09939aab-731e-437d-ae0f-7348bfa4ed2e/balance?date=2026-06-30" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": {
    "entite_id": "09939aab-731e-437d-ae0f-7348bfa4ed2e",
    "date": "2026-06-30",
    "comptes": [
      {
        "compte": "1031",
        "libelle": "Avances de trésorerie",
        "debit_cents": 0,
        "credit_cents": 1627000,
        "solde_cents": -1627000,
        "tiers": 0
      },
      {
        "compte": "105",
        "libelle": "Fonds de travaux",
        "debit_cents": 0,
        "credit_cents": 2440000,
        "solde_cents": -2440000,
        "tiers": 0
      },
      {
        "compte": "401",
        "libelle": "Fournisseurs — factures parvenues",
        "debit_cents": 2194620,
        "credit_cents": 2194620,
        "solde_cents": 0,
        "tiers": 7
      },
      {
        "compte": "4501",
        "libelle": "Copropriétaire — budget prévisionnel",
        "debit_cents": 1879000,
        "credit_cents": 2039751,
        "solde_cents": -160751,
        "tiers": 16
      }
    ],
    "total_debit_cents": 12436991,
    "total_credit_cents": 12436991
  }
}

Exemple : écritures

Journal des achats (AC) d’un syndicat, une écriture par page.

curl "https://gerelio.com/api/v1/ecritures?entite_id=09939aab-731e-437d-ae0f-7348bfa4ed2e&journal=AC&limite=1" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": [
    {
      "id": "00df1e77-0b10-4601-a8a4-264b0cc6951f",
      "entite_id": "09939aab-731e-437d-ae0f-7348bfa4ed2e",
      "numero": 84,
      "journal": "AC",
      "date_ecriture": "2026-07-10",
      "libelle": "Maintenance ascenseur — trimestre 3 — ARS-2026-T3",
      "piece_ref": "ARS-2026-T3",
      "origine_type": "facture",
      "origine_id": "9b6a551f-323a-45da-ac22-965ec8edcdbb",
      "contrepasse_de": null,
      "hash": "f7b788e56bd7b1dee94eb9435d66825f75910479ba3a4abe6865126b0d8b8805",
      "hash_precedent": "95d1063ef7a24875d44f9ecf160915a7e45b765cd73dba667cfde848dd5caaa4",
      "lignes": [
        {
          "compte": "614",
          "libelle": null,
          "personne_id": null,
          "lot_id": null,
          "cle_id": "bced491a-02dd-4155-8d8a-bdb6022ed174",
          "debit_cents": 105000,
          "credit_cents": 0
        },
        {
          "compte": "401",
          "libelle": null,
          "personne_id": "ad4bdd53-d560-40c8-b1f3-37484395f406",
          "lot_id": null,
          "cle_id": null,
          "debit_cents": 0,
          "credit_cents": 105000
        }
      ],
      "cree_le": "2026-09-26T11:37:35.877+00:00"
    }
  ],
  "a_suivre": true,
  "curseur_suivant": "MjAyNi0wOS0yNlQxMTozNzozNS44NzcwMDBafDAwZGYxZTc3LTBiMTAtNDYwMS1hOGE0LTI2NGIwY2M2OTUxZg"
}

Appels de fonds

Appels de fonds émis, avec la part de chaque lot (budget et fonds de travaux). lien ouvre l’appel dans l’espace Gerelio (connexion requise).

• GET /appels-de-fonds Liste
• GET /appels-de-fonds/{id} Un appel

curl "https://gerelio.com/api/v1/appels-de-fonds?immeuble_id=119be282-fe81-4a6d-b6a1-32c3356495d9&limite=1" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": [
    {
      "id": "4444237d-cb95-47d4-a23e-167ee3ca8f8b",
      "immeuble_id": "119be282-fe81-4a6d-b6a1-32c3356495d9",
      "type": "budget",
      "annee": 2026,
      "trimestre": 1,
      "libelle": "Appel de fonds Le Clos Saint-Martin — T1 2026",
      "date_echeance": "2026-01-01",
      "total_budget_cents": 380500,
      "total_fonds_travaux_cents": 40625,
      "total_cents": 421125,
      "emis": true,
      "ecriture_id": "8f6b86d0-ad62-48f2-9a1b-53db0d54b321",
      "lien": "https://gerelio.com/espace/documents/appel/4444237d-cb95-47d4-a23e-167ee3ca8f8b",
      "lignes": [
        {
          "lot_id": "e624ede2-d056-41d7-b352-c9abf01fcd76",
          "lot_numero": "B01",
          "personne_id": "f0ac096e-3c47-4014-b4d4-9ad5a8415877",
          "budget_cents": 39838,
          "fonds_travaux_cents": 4253,
          "total_cents": 44091
        },
        {
          "lot_id": "403284af-567f-4236-ab7b-3ebaa4ba88e7",
          "lot_numero": "B02",
          "personne_id": "baa41e84-2223-47a3-95dd-9928987f36d1",
          "budget_cents": 31155,
          "fonds_travaux_cents": 3326,
          "total_cents": 34481
        }
      ],
      "cree_le": "2026-09-26T11:37:35.877+00:00"
    }
  ],
  "a_suivre": true,
  "curseur_suivant": "MjAyNi0wOS0yNlQxMTozNzozNS44NzcwMDBafDQ0NDQyMzdkLWNiOTUtNDdkNC1hMjNlLTE2N2VlM2NhOGY4Yg"
}

Factures fournisseurs

Factures reçues, à valider, validées (comptabilisées), payées ou rejetées.

• GET /factures Liste
• GET /factures/{id} Une facture
• POST /factures Enregistrer (voir Écriture)

curl "https://gerelio.com/api/v1/factures?statut=validee&limite=1" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": [
    {
      "id": "16beb596-7016-48be-8fce-1d5bfff9987b",
      "entite_id": "09939aab-731e-437d-ae0f-7348bfa4ed2e",
      "fournisseur_id": "e624740c-9adb-45c8-afde-f447f27a00cb",
      "fournisseur_nom": "Enerlyon Services",
      "numero": "E-2026-08-TIL",
      "date_facture": "2026-08-08",
      "date_echeance": "2026-09-07",
      "libelle": "Électricité parties communes",
      "montant_ttc_cents": 53680,
      "compte_charge": "602",
      "cle_id": "16065ea2-0e4e-469b-b0a1-4c6b681d4b0d",
      "lot_id": null,
      "source": "plateforme_agreee",
      "statut": "validee",
      "motif_rejet": null,
      "ecriture_id": "0ab7ec28-dba4-48e9-bd43-f66b55d25765",
      "ecriture_paiement_id": null,
      "cree_le": "2026-09-26T11:37:35.877+00:00"
    }
  ],
  "a_suivre": false,
  "curseur_suivant": null
}

Opérations bancaires

Opérations des relevés bancaires importés, et leur rapprochement.

• GET /releves Liste
• GET /releves/{id} Une opération
• POST /releves Importer un relevé (voir Écriture)

curl "https://gerelio.com/api/v1/releves?entite_id=09939aab-731e-437d-ae0f-7348bfa4ed2e&statut=a_rapprocher" \
  -H "Authorization: Bearer $GERELIO_CLE"

Assemblées générales

Assemblées, leurs résolutions et, une fois clôturées, le résultat de chaque vote (majorités des articles 24, 25, 25-1 et 26) et le lien du procès-verbal.

• GET /assemblees Liste
• GET /assemblees/{id} Une assemblée

curl "https://gerelio.com/api/v1/assemblees/2b584c43-b9ce-4b41-ba35-4d88ecf10def" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": {
    "id": "2b584c43-b9ce-4b41-ba35-4d88ecf10def",
    "immeuble_id": "1d8969c0-c381-4a46-956a-b809cbad14bd",
    "type": "ordinaire",
    "date_ag": "2026-05-14T18:30:00+00:00",
    "lieu": "Salle paroissiale, 20 rue Duguesclin, Lyon 6e",
    "statut": "pv_diffuse",
    "convoquee_le": "2026-04-14",
    "tenue_le": "2026-05-14",
    "president_nom": "Mme Claire Moreau",
    "secretaire_nom": "Cabinet Delorme & Associés",
    "resolutions": [
      {
        "id": "04afc43a-c8e6-4d9c-b4e5-621e3a984a65",
        "ordre": 1,
        "titre": "Approbation des comptes de l'exercice 2025",
        "texte": "L'assemblée générale approuve les comptes de l'exercice 2025 en leur forme, teneur, imputation et répartition.",
        "majorite": "art24",
        "nature": "approbation_comptes",
        "resultat": {
          "regle": "Majorité des voix exprimées (art. 24)",
          "adoptee": true,
          "votants": 13,
          "voix_pour": 10650,
          "defaillants": 0,
          "voix_contre": 0,
          "membres_pour": 13,
          "membres_total": 16,
          "passerelle_25_1": false,
          "voix_abstention": 0,
          "voix_defaillantes": 0,
          "voix_total_syndicat": 12750
        }
      }
    ],
    "proces_verbal": {
      "diffuse": true,
      "document_id": "df6b3b6f-8715-46d1-abda-db15e05f99ec",
      "lien": "https://gerelio.com/espace/documents/pv/2b584c43-b9ce-4b41-ba35-4d88ecf10def"
    },
    "cree_le": "2026-09-26T11:37:35.877+00:00"
  }
}

Documents

Documents du cabinet : générés par Gerelio (appels de fonds, procès-verbaux, fiches synthétiques, convocations) ou déposés. lien ouvre le document dans l’espace Gerelio (connexion requise).

• GET /documents Liste
• GET /documents/{id} Un document

curl "https://gerelio.com/api/v1/documents?genere=true&limite=1" \
  -H "Authorization: Bearer $GERELIO_CLE"

{
  "donnees": [
    {
      "id": "1254c658-2605-4413-b8e1-5ddc3944010d",
      "immeuble_id": "1d8969c0-c381-4a46-956a-b809cbad14bd",
      "lot_id": null,
      "personne_id": null,
      "categorie": "compte_coproprietaire",
      "titre": "Appel de fonds Résidence Les Tilleuls — T2 2026",
      "date_document": "2026-09-26",
      "genere": true,
      "source_type": "appel",
      "source_id": "03c278b9-ea29-4576-aae4-54f1adf99a84",
      "publie_extranet": true,
      "lien": "https://gerelio.com/espace/documents/appel/03c278b9-ea29-4576-aae4-54f1adf99a84",
      "cree_le": "2026-09-26T11:37:35.877+00:00"
    }
  ],
  "a_suivre": true,
  "curseur_suivant": "MjAyNi0wOS0yNlQxMTozNzozNS44NzcwMDBafDEyNTRjNjU4LTI2MDUtNDQxMy1iOGUxLTVkZGMzOTQ0MDEwZA"
}