---
title: "Résultats des veilles et des alertes"
method: GET
path: "/alertes/{alerte}/resultats"
---

# Résultats des veilles et des alertes

`GET /alertes/{alerte}/resultats`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/alertes/{alerte}/resultats`
- Auth: HTTP bearer

Ce que les veilles et les alertes du compte de la clé ont remonté, du plus ancien au plus récent : pour un agent de veille, les annonces retenues avec le signal et la raison du juge IA ; pour un suivi de zone, les signaux par volet avec leur clé, leur score et leur instantané ; pour une veille pré-marché, les adresses avec leur priorité et leur probabilité. Chaque résultat dit s'il est déjà parti dans une notification du compte. Un crédit par résultat rendu, sauf un résultat déjà livré et débité par un abonnement webhook. Exige une clé rattachée à un compte Pillr. Coût : 1 crédit par évènement livré.

## Path parameters

- `alerte` string, uuid, required: Identifiant d'un suivi de zone ou d'une veille pré-marché.

## Response `200`

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

- object
  - `resultats` object[], required: Les résultats, du plus ancien au plus récent.
    - `id` string, required
    - `alerte_id` string, required: Identifiant de la veille ou de l'alerte qui a remonté ce résultat.
    - `genre` 'annonce' | 'signal_zone' | 'adresse_pre_marche', required: annonce (agent de veille), signal_zone (suivi de zone) ou adresse_pre_marche (veille pré-marché).
    - `annonce_id` string, nullable, required
    - `cle_ban` string, nullable, required
    - `volet` string, nullable, required: Volet d'un suivi de zone : pre_marche, particuliers ou marche.
    - `signal` string, nullable, required: Le signal : new, price_drop, nego, multi_agency, ai (veilles) ; pre_marche, stagne, baisse_pap, republie, baisse, multi_mandat (zones).
    - `detail` object, nullable, required: Le contexte du signal (ancien et nouveau prix, décote, raison du juge IA).
    - `score` number, nullable, required: Ordre d'affichage dans le volet d'un suivi de zone.
    - `priorite` number, nullable, required: Priorité d'une adresse du pré-marché (probabilité de mise en vente multipliée par la fenêtre de mandat).
    - `p_mise_en_vente_6m` number, nullable, required: Probabilité de mise en vente sous 6 mois d'une adresse du pré-marché.
    - `instantane` object, nullable, required: L'annonce ou l'adresse telle qu'elle était au moment du signal.
    - `le` string, required: Date du résultat.
    - `notifie` boolean, required: Vrai si ce résultat est déjà parti dans une notification du compte.
    - `livre_par_webhook` boolean, required: Vrai si ce résultat a déjà été livré et débité par un abonnement webhook : il n'est pas débité de nouveau.
    - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
      - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
      - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
      - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
        - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
        - `bas` number, nullable, required
        - `haut` number, nullable, required
      - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
      - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
      - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
      - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `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)