---
title: "Résultat : dossier de dépôt"
method: GET
path: "/urbanisme/dossiers/{tache}"
---

# Résultat : dossier de dépôt

`GET /urbanisme/dossiers/{tache}`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/urbanisme/dossiers/{tache}`
- Auth: HTTP bearer

État et résultat d'une tâche lancée par POST /urbanisme/dossiers (outil preparer_dossier) : statut, sortie complète quand elle est terminée, erreur quand elle a échoué (ses crédits sont alors rendus). Le paramètre attendre patiente jusqu'à 60 s. Coût : 0 crédit par appel réussi.

## Path parameters

- `tache` string, required: Identifiant de la tâche rendu au lancement (tache.id).

## Query parameters

- `attendre` integer: Secondes d'attente de la fin de la tâche avant de répondre (60 au plus).

## Response `200`

Tâche terminée (resultat) ou échouée (erreur, crédits rendus).

- object
  - `tache` object, required: La tâche asynchrone.
    - `id` string, required: Identifiant de la tâche, à passer à l'opération de résultat.
    - `operation` string, required
    - `statut` 'en_attente' | 'en_cours' | 'terminee' | 'echouee', required: en_attente, en_cours, terminee (resultat rempli) ou echouee (erreur remplie, crédits rendus).
    - `cree_le` string, required
    - `termine_le` string, nullable, required
    - `expire_le` string, required: Date au-delà de laquelle le résultat n'est plus conservé.
    - `resultat_url` string, required: Chemin de lecture du résultat (GET).
  - `resultat` object, nullable, required: La sortie de l'opération, quand la tâche est terminée ; null sinon.
    - `statut` 'pret' | 'formalite_non_etablie' | 'aucune_formalite' | 'question_maison_individuelle', required: pret : la liste des pièces est établie ; sinon le message dit ce qui manque.
    - `message` string, nullable, required
    - `formalite` 'aucune' | 'declaration_prealable' | 'permis_de_construire' | 'permis_d_amenager' | 'permis_de_demolir', nullable, required
    - `libelle_formalite` string, nullable, required
    - `formalite_source` 'croquis' | 'demarche', nullable, required
    - `cerfa` object, nullable, required: Le formulaire retenu : il se pré-remplit par l'opération cerfa avec donnees_cerfa.
      - `numero` string, required
      - `libelle` string, required
      - `fichier` string, required
      - `url_officielle` string, required
    - `donnees_cerfa` object, required: Les faits du dossier pour le Cerfa (terrain, références cadastrales, nature des travaux, emprise) : l'entrée donnees de l'opération cerfa.
    - `cases_a_completer` object[], required
      - `rubrique` string, required
      - `libelle` string, required
      - `raison` string, required
    - `terrain` object, required
      - `adresse` string, nullable, required
      - `parcelle` string, required
      - `commune` string, nullable, required
      - `idu` string, required
    - `pieces` object[], required
      - `code` string, nullable, required: Code du bordereau (DPC1, PCMI2...).
      - `libelle` string, required
      - `role` string, required: Ce que la pièce doit montrer, d'après le bordereau du Cerfa.
      - `etat` 'prete' | 'a_completer' | 'a_produire' | 'a_fournir', required: prete : produite par Pillr depuis le croquis ou les coupes ; a_produire : par l'opération dite ; a_fournir : par le demandeur (photos, insertion).
      - `exigee` 'oui' | 'selon_le_projet', required
      - `a_confirmer` boolean, required
      - `complement` boolean, required: Joint hors bordereau (vue aérienne).
      - `consigne` string, nullable, required
      - `operation` 'croquis_projet' | 'coupes_facades' | 'generer_document', nullable, required: L'opération qui produit ou produirait la pièce.
      - `fichier` string, nullable, required: Nom du fichier de la pièce dans le dossier du Hub.
    - `manques` string[], required: Ce qui manque au dossier, dit en clair.
    - `alertes` string[], required: Points à corriger dans le croquis avant tout dépôt.
    - `notes` string[], required
    - `maison_individuelle` boolean, nullable, required
    - `coupes` object, required: Les coupes et façades dessinées dans l'appel, ou pourquoi elles ne l'ont pas été.
      - `dessinees` boolean, required
      - `refus` string, nullable, required
    - `archive` string, nullable, required: Nom de l'archive du dossier dans le Hub (statut pret).
    - `limites` string[], required
    - `genere_le` string, required
  - `erreur` object, nullable, required: Pourquoi la tâche a échoué ; null sinon.
    - `code` string, required
    - `detail` string, 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

- `202`: Tâche acceptée, pas encore terminée : lire le résultat à l'adresse de l'en-tête Location (ou attendre avec le paramètre attendre).
- `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
- `404`: Tâche introuvable
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API 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)