fonciqAPI
Lots

Lire la fiche d'un lot

Portée `lots:read`. Cette lecture interroge les rôles d'évaluation foncière des municipalités du Québec, l'un des jeux de données publics intégrés aux Données Fonciq. Elle ne débite pas Fonciq. La fiche réunit le cadastre, l'évaluation du rôle en cents et les lignes d'index de `registre.entries`. Même objet qu'une tâche terminée. Cette opération ne tire pas un index. JSON par défaut. `format=csv` ou `Accept: text/csv` renvoie ces lignes en CSV à la place de la fiche. `format` l'emporte. Toute autre valeur de `format` reçoit `400` et le code `invalid_request`.

GET
/v1/lots/{lot}
AuthorizationBearer <token>

Clé d'API de l'organisation. Le secret n'est montré qu'une fois. Le préfixe affichable d'une clé d'essai est fq_test_. Le hachage SHA-256 est la seule forme conservée. Le panneau d'essai de cette documentation n'envoie qu'une clé fq_test_ et n'effectue aucun débit.

Dans : en-tête

Paramètres de chemin

lotstring

Numéro de lot.

Paramètres de requête

format?string

json est le défaut. csv, ou l'en-tête Accept: text/csv lorsque format est absent, sélectionne le CSV. format l'emporte lorsque les deux sont envoyés. Toute autre valeur reçoit 400 et le code invalid_request.

Défaut"json"
Valeurs"json" | "csv"

Corps de la réponse

application/json

application/json

application/json

application/json

curl -X GET "https://api.fonciq.ca/v1/lots/1234567"
{
  "lot": "1234567",
  "cadastre": {
    "label": "Cadastre du Québec",
    "lot": "1234567"
  },
  "assessment": {
    "year": 2026,
    "value_cents": 45000000
  },
  "registre": {
    "entries": [
      {
        "lot": "1234567",
        "source_document_id": "42",
        "position": 0,
        "inscription": "21 014 436",
        "presentation_date": "2024-03-12",
        "nature": "Vente",
        "parties": [
          {
            "role": "Vendeur",
            "name": "EXEMPLE, MARIE"
          }
        ],
        "remarks": null,
        "radiations": [],
        "read_method": null,
        "confidence": "unscored",
        "needs_review": null
      }
    ]
  }
}
{
  "error": {
    "code": "invalid_request",
    "message": "Indiquer une adresse ou un matricule.",
    "request_id": "req_01HZX"
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Clé d'API refusée.",
    "request_id": "req_01HZX"
  }
}
{
  "error": {
    "code": "account_not_found",
    "message": "Ce compte du Registre n'appartient pas à l'organisation.",
    "request_id": "req_01HZX"
  }
}
{
  "error": {
    "code": "rate_limited",
    "message": "Trop de requêtes pour cette clé.",
    "request_id": "req_01HZX"
  }
}