From 8a11a1d5ea30d3315e51b905d29e8dd9ddc8ec0b Mon Sep 17 00:00:00 2001
From: GnomeZworc <nicolas.boufidjeline@g3e.fr>
Date: Sun, 14 Jun 2026 22:29:35 +0200
Subject: [PATCH] add pending path

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
---
 docs/api.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/api.md b/docs/api.md
index f763191..7b891a1 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -477,6 +477,29 @@ Liste les positions détaillées (par instrument) du compte jour par jour.
 
 ---
 
+### `GET /snapshots/pending`
+
+Liste tous les comptes de l'owner ayant une invalidation en attente (i.e. snapshots non à jour suite à une mutation de transaction).
+
+Utile pour savoir quels comptes doivent être recalculés avant de consulter leurs snapshots, ou pour déclencher un `recompute` ciblé.
+
+**Réponse `200`** — liste vide si tout est à jour
+```json
+[
+  { "account_id": 1, "recompute_from": "2026-06-10" },
+  { "account_id": 3, "recompute_from": "2026-05-01" }
+]
+```
+
+| Champ | Description |
+|---|---|
+| `account_id` | Identifiant du compte à recalculer |
+| `recompute_from` | Date la plus ancienne depuis laquelle les snapshots sont invalides |
+
+> Les invalidations sont insérées automatiquement à chaque create / update / delete / validate de transaction. Le job `daily-snapshot` les consomme toutes les 24h ; cet endpoint permet de les inspecter sans attendre.
+
+---
+
 ### `POST /accounts/{id}/snapshots/recompute`
 
 Recalcule immédiatement les snapshots d'un compte depuis sa **date d'invalidation** jusqu'à `today + horizon`.