---
title: "Projets du compte"
method: GET
path: "/projets"
---

# Projets du compte

`GET /projets`

## Request

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

Les projets de l'utilisateur de la clé (achat, mandat de vente, location et gestion) : titre, étape, annonce suivie, adresse, faits, échéances, date de clôture et nombre de conversations du Hub rattachées. Les projets ouverts d'abord, puis les plus récemment modifiés. Exige une clé rattachée à un compte Pillr. Coût : 0 crédit par appel réussi.

## Query parameters

- `clos` union: Vrai : les projets clos seulement ; faux : les ouverts seulement ; absent : tous.
  - boolean
  - 'true' | 'false' | 'oui' | 'non'

## Response `200`

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

- object
  - `projets` object[], required
    - `id` string, uuid, required
    - `type` string, required
    - `titre` string, required
    - `etape` string, required
    - `annonce_id` string, nullable, required: Identifiant Pillr de l'annonce suivie.
    - `adresse` string, nullable, required
    - `faits` object, required: Faits du projet (clés libres ; textes et urbanisme sont réservés).
    - `echeances` object[], required
    - `clos_le` string, nullable, required: Horodatage ISO 8601.
    - `cree_le` string, nullable, required: Horodatage ISO 8601.
    - `maj_le` string, nullable, required: Horodatage ISO 8601.
    - `nb_conversations` integer, required
  - `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
- `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)