Listing de bâtiments

Tous nos points d'accès acceptent un paramètre optionnel supplémentaire from qui vous permet de renseigner une adresse mail. Celle-ci nous permettra de vous prévenir en cas de changement sur l'un des endpoints qui vous utilisez.

Par exemple : https://rnb-api.beta.gouv.fr/api/alpha/buildings/?from=[e-mail]

Liste des batiments

Ce endpoint permet de récupérer une liste paginée de bâtiments. Des filtres, notamment par code INSEE de la commune, sont disponibles. NB : l'URL se termine nécessairement par un slash (/).

GEThttps://rnb-api.beta.gouv.fr/api/alpha/buildings/

Query parameters

Response

200

Liste paginée de bâtiments

Body

application/json

nextnullable string

URL de la page de résultats suivante

Example: "https://rnb-api.beta.gouv.fr/api/alpha/buildings/?cursor=cD02MzQ3OTk1"

previousnullable string

URL de la page de résultats précédente

Example: "https://rnb-api.beta.gouv.fr/api/alpha/buildings/?cursor=hFG78YEdFR"

resultsarray of all of

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://rnb-api.beta.gouv.fr/api/alpha/buildings/', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "next": "https://rnb-api.beta.gouv.fr/api/alpha/buildings/?cursor=cD02MzQ3OTk1",
  "previous": "https://rnb-api.beta.gouv.fr/api/alpha/buildings/?cursor=hFG78YEdFR",
  "results": [
    {
      "rnb_id": "PG46YY6YWCX8",
      "status": "constructed",
      "point": {
        "type": "Point",
        "coordinates": [
          -0.570505392116188,
          44.841034137099996
        ]
      },
      "shape": {
        "type": "Point",
        "coordinates": [
          [
            -0.570505392116188,
            44.841034137099996
          ]
        ]
      },
      "addresses": [
        {
          "id": "02191_0020_00003",
          "source": "bdnb",
          "street_number": "3",
          "street_rep": "bis",
          "street": "rue de l'église",
          "city_name": "Chivy-lès-Étouvelles",
          "city_zipcode": "02000",
          "city_insee_code": 2191
        }
      ],
      "ext_ids": [
        {
          "id": "bdnb-bc-3B85-TYM9-FDSX",
          "source": "bdnb",
          "source_version": "2023_01",
          "created_at": "2023-12-07T13:20:58.310444+00:00"
        }
      ],
      "plots": [
        {
          "id": "01402000AB0051",
          "bdg_cover_ratio": 0.403
        }
      ]
    }
  ]
}