---
title: "Créer une veille pré-marché"
method: POST
path: "/alertes/pre-marche"
---

# Créer une veille pré-marché

`POST /alertes/pre-marche`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/alertes/pre-marche`
- Auth: HTTP bearer

Crée une veille pré-marché rattachée au compte de la clé, sur un secteur (commune, code INSEE, code postal ou disque autour d'un point) : chaque nuit, les nouvelles adresses dont la priorité dépasse le seuil. Le compte garde un plafond de veilles pré-marché actives. Exige une clé rattachée à un compte Pillr. Coût : 0 crédit par appel réussi.

## Request body

- object
  - `commune` string: Nom de la commune suivie.
  - `insee` string: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
  - `cp` string: Code postal.
  - `autour` object: Un disque autour d'un point : le seul moyen d'enregistrer un rayon.
    - `lat` number, required
    - `lon` number, required
    - `rayon_km` number: Rayon en km (borné par le moteur des alertes).
  - `type_bien` 'maison' | 'appartement' | 'tous'
  - `nom` string
  - `seuil_priorite_pct` integer: Seuil de priorité, en %.

## Response `201`

Ressource créée.

- object
  - `alertes` object[], required: Les alertes créées : une par commune pour une liste de communes ou une intercommunalité.
    - `id` string, required
    - `formule` 'suivi_de_zone' | 'pre_marche_seul', required
    - `nom` string, nullable, required
    - `secteur` string, nullable, required: Le secteur en une ligne (« Gex · tous biens »).
    - `volets` string[], required: Ce que l'alerte surveille, en clair, une phrase par volet actif.
    - `seuil_priorite_pct` number, nullable, required
    - `jours_min` number, nullable, required
    - `frequence` string, nullable, required
    - `active` boolean, required
    - `par_courriel` boolean, required: Vrai si les résultats partent aussi dans le courriel du matin du compte.
    - `dernier_passage` string, nullable, required
    - `cree_le` string, nullable, required
  - `perimetre_enregistre` object, required: Ce que la ou les alertes surveillent réellement, relu sur ce qui a été enregistré.
    - `communes` object[], required
      - `commune` string, nullable, required
      - `insee` string, nullable, required
    - `code_postal` string, nullable, required
    - `rayon` object, nullable, required
      - `lat` number, required
      - `lon` number, required
      - `rayon_km` number, required
    - `type_bien` string, required
    - `phrase` string, required: Le périmètre enregistré, en clair.
  - `deja_suivies` string[], required: Communes déjà suivies par une alerte active, non recréées.
  - `introuvables` string[], required
  - `non_creees` object[], required
    - `commune` string, required
    - `raison` string, required
  - `doublon_possible` string, nullable, required: Nom d'une alerte active qui couvre déjà ce secteur ; null sinon.
  - `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

- `400`: Paramètres invalides
- `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)