---
title: "Notifications du compte"
method: GET
path: "/compte/notifications"
---

# Notifications du compte

`GET /compte/notifications`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/compte/notifications`
- Auth: HTTP bearer

Les signaux détectés chaque matin sur ce que suit l'utilisateur de la clé : baisse de prix d'un favori (price_drop), annonce sur-cotée en ligne depuis plus de soixante jours sans baisse (nego_opportunity), valorisation possible après des travaux raisonnables (post_works_profit), prix en baisse dans une commune suivie (zone_trend). Les plus récentes d'abord, les écartées exclues sauf demande. Le scan ne tourne que pour les comptes qui ont un profil investisseur. Exige une clé rattachée à un compte Pillr. Coût : 1 crédit par évènement livré.

## Query parameters

- `depuis` string: Les notifications créées à partir de cette date.
- `types` union: Types à rendre (paramètre répétable).
  - 'price_drop' | 'nego_opportunity' | 'post_works_profit' | 'zone_trend'
  - string[]
- `non_lues` union: Vrai : les non lues seulement.
  - boolean
  - 'true' | 'false' | 'oui' | 'non'
- `ecartees` union: Vrai : inclut les notifications écartées.
  - boolean
  - 'true' | 'false' | 'oui' | 'non'
- `limite` integer: Nombre d'éléments par page (50 au plus).
- `curseur` string: Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `notifications` object[], required
    - `id` string, uuid, required
    - `type` string, required: price_drop, nego_opportunity, post_works_profit ou zone_trend.
    - `annonce_id` string, nullable, required: Identifiant Pillr de l'annonce concernée.
    - `importance` string, required: basse, moyenne ou haute.
    - `titre` string, required
    - `message` string, required
    - `charge` object, required: Le détail du signal, tel que le scan l'a écrit.
    - `cree_le` string, nullable, required: Horodatage ISO 8601.
    - `lue_le` string, nullable, required: Horodatage ISO 8601.
    - `ecartee_le` string, nullable, required: Horodatage ISO 8601.
  - `non_lues` integer, required: Notifications non lues et non écartées du compte.
  - `curseur_suivant` string, nullable, required: Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `304`: Non modifiée depuis l'ETag fourni : rien n'est débité.
- `400`: Paramètres invalides ; Curseur invalide
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante ; Clé sans compte rattaché
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible ; Donnée momentanément indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)