---
title: "Taux de crédit du moment"
method: GET
path: "/taux-credit"
---

# Taux de crédit du moment

`GET /taux-credit`

## Request

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

Taux de crédit immobilier du moment par durée (bon taux, très bon taux, taux excellent), lus dans le tableau du baromètre public de meilleurtaux.com, avec la date de sa simulation. Lecture d'une page tierce sans API ni contrat : si le tableau change de forme ou ne répond pas, l'opération répond « donnée indisponible », jamais un taux de repli. Réponse gardée 6 heures. Coût : 1 crédit par appel réussi.

## Response `200`

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

- object
  - `taux` object[], required: Taux nominaux par durée, hors assurance, tels que le baromètre les publie.
    - `duree_ans` integer, required
    - `bon_pct` number, nullable, required: « Bon taux » du baromètre, en % par an.
    - `tres_bon_pct` number, nullable, required: « Très bon taux » du baromètre, en % par an.
    - `excellent_pct` number, nullable, required: « Taux excellent » du baromètre, en % par an.
  - `simulation_du` string, nullable, required: Date de la simulation publiée par le baromètre (AAAA-MM-JJ).
  - `lu_le` string, required: Horodatage de la lecture de la page.
  - `source` string, required
  - `url` string, required
  - `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.
  - `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
- `404`: Ressource absente : rien n'est débité
- `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)