GET /eco/immo/offres/:id

A propos

Cette requête permet d'accéder à toutes les informations d'une offre immobilière publiée.

Consultez la description du modèle pour plus d'informations.

Informations

URL https://api.solutions-territoire.fr/v0/eco/immo/offres/:id
Disponibilité 0.7.0
Authentification requise Authorization Code ou Client Credentials
Scope requis Accés aux données économiques
Formats disponibles JSON
Code HTTP attendu 200

Paramètres

Aucun paramètre disponible.

Réponse

offre Object Toutes les propriétés d'une offre immobilière

Exemple

Les exemples ci-dessous utilises la variable $ACCESS_TOKEN décrite dans la section Exemple : authentification en ligne de commande.

cURL :

curl -X GET \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.solutions-territoire.fr/v0/eco/immo/offres/2019-09-00067

HTTPie :

http -v GET https://api.solutions-territoire.fr/v0/eco/immo/offres/2019-09-00067 \
  Accept:"application/json" \
  Authorization:"Bearer $ACCESS_TOKEN"

Résultat :

GET /v0/eco/immo/offres/2019-09-00067 HTTP/1.1
Accept: application/json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "offre": {
        "id":                              "2019-09-00067",
        "reference":                       "2019-09-00067",
        "local_type":                      "local_commercial",
        "label":                           "Grand local commercial à Paris",
        "code_commune":                    "34172",
        "libelle_commune":                 "Montpellier",
        "surface":                         320,
        "transaction_types":               ["acheter", "louer"],
        "tags":                            ["cave", "extraction"],
        "address":                         "1 RUE DU GENERAL-LECLERC",
        "annee_de_construction":           1998,
        "parking_number":                  8,
        "disponibilite":                   "2021-10-21",
        "descriptif_bien":                 "Un local commercial à louer ou acheter.",
        "descriptif_surface":              "Vaste open-space de 320m2.",
        "descriptif_caracteristique":      "Cuisine équipée et portes-fenêtres verrouillables.",
        "acces":                           "Parking sur place, accés PMR par ascenseur",
        "descriptif_tarif":                "",
        "prix_de_vente":                   200000.0,
        "taxe_fonciere":                   698.50,
        "pourcentage_honoraire_acquereur": 2.05,
        "loyer_mensuel":                   900.0,
        "charges_locatives":               150.3,
        "divisible_at":                    1234,
        "url":                             "https://api.solutions-territoire.fr/v0/eco/immo/offres/2019-09-00067",
        "photos": [
          {
              "filename":   "photo.jpg",
              "url":        "https://storage.mon-territoire.fr/jT2LvkK6H2xNqG5uCwa19fglnArY?20filename=photo.jpg?Signature=edD2ZOmXvXqTFBcF6tE3BtHUVByL"
              "created_at": "2021-09-04T11:05:09.155+02:00",
          },
          {
              "filename":   "photo-2.jpg",
              "url":        "https://storage.mon-territoire.fr/3g7wnbfhZ4b2AYMGQDCRdzwGOFqI?20filename=photo-2.jpg?Signature=RPagqhP3WVBARurPTpN5llbXv58o"
              "created_at": "2021-09-04T16:15:18.154+02:00",
          }
        ]
    }
}