---
title: "Fichiers complets des jeux"
method: GET
path: "/exports"
---

# Fichiers complets des jeux

`GET /exports`

## Request

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

Les éditions des fichiers complets que le contrat de l'organisation ouvre (jeux de son périmètre, droit d'export actif), plus les éditions communes : pour chacune, le jeu, la date d'édition, le format, la taille, le nombre de lignes, l'empreinte SHA-256, la présence du dictionnaire et de la fiche qualité, et le chemin de téléchargement. Seules les éditions dont la volumétrie a été contrôlée avant l'envoi sont listées. Réservé aux contrats ; REST seulement. Coût : 0 crédit par appel réussi.

## Query parameters

- `jeu` 'annonces' | 'evenements_prix' | 'diffusion' | 'biens' | 'adresses' | 'dvf_adresse' | 'dpe' | 'audits' | 'coproprietes' | 'permis' | 'societes_civiles' | 'pre_marche' | 'communes' | 'iris' | 'urbanisme' | 'agences' | 'indice_travaux' | 'barometre' | 'tuiles': Jeu exportable, tel que le périmètre du contrat le nomme.

## Response `200`

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

- object
  - `editions` object[], required: Les éditions ouvertes par le contrat, la plus récente d'abord.
    - `jeu` string, required
    - `date` string, required: Date de l'édition (AAAA-MM-JJ).
    - `format` 'parquet' | 'csv.gz' | 'geoparquet' | 'pmtiles', required
    - `taille_octets` number, nullable, required
    - `lignes` number, nullable, required
    - `sha256` string, nullable, required: Empreinte SHA-256 du fichier.
    - `dictionnaire` boolean, required: Vrai : le dictionnaire des colonnes accompagne l'édition.
    - `fiche_qualite` boolean, required: Vrai : la fiche qualité accompagne l'édition.
    - `perimetre` 'contrat' | 'echantillon', required: contrat : édition propre au contrat ; echantillon : édition commune.
    - `genere_le` string, nullable, required
    - `telechargement` string, required: Chemin du téléchargement (redirection vers le fichier).
  - `duree_lien_s` integer, required: Validité d'une adresse de téléchargement, en secondes.
  - `retrait_particuliers` 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

- `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 ; Palier insuffisant
- `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)