> ## Documentation Index
> Fetch the complete documentation index at: https://docs.urbanora.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Journal des changements

> Changements détectés sur les bâtiments suivis, du plus ancien au plus récent. Garder `curseur` et le repasser dans `depuis` à l'appel suivant ; `encore` indique qu'il reste des lignes. `donnee` est l'une de : decisionnaires, caracteristiques, fibre, copropriete, proprietaires, gestionnaires, occupants, permis, stationnement, energie, urbanisme. Relire ensuite `GET /v1/batiment?imb=…&donnees=…`.



## OpenAPI

````yaml /openapi.json get /v1/changements
openapi: 3.1.0
info:
  title: Urbanora Partner API
  description: >-
    API Urbanora. Un bâtiment (IMB, parcelle ou adresse) → toutes ses données,
    avec leurs sources et leur date de mise à jour ; un contact demandé pour une
    entreprise ou un dirigeant du bâtiment ; le suivi des bâtiments qui
    changent. Clé API dans `X-Api-Key`. Erreurs : `{ error: { code, message },
    request_id }`. Fair use : 600 appels par minute et 20 000 par jour
    (Europe/Paris) par clé ; au-delà 429 `RATE_LIMIT_EXCEEDED`, headers
    `X-RateLimit-*` et `X-RateLimit-Daily-*`.
  version: 2.0.0
servers:
  - url: https://partner.urbanora.fr
    description: Production
  - url: http://127.0.0.1:8086
    description: Développement
security:
  - apiKey: []
tags:
  - name: batiment
    description: Données d'un bâtiment
  - name: contacts
    description: Demandes de contact
  - name: suivi
    description: Bâtiments suivis et changements
paths:
  /v1/changements:
    get:
      tags:
        - suivi
      summary: Journal des changements
      description: >-
        Changements détectés sur les bâtiments suivis, du plus ancien au plus
        récent. Garder `curseur` et le repasser dans `depuis` à l'appel suivant
        ; `encore` indique qu'il reste des lignes. `donnee` est l'une de :
        decisionnaires, caracteristiques, fibre, copropriete, proprietaires,
        gestionnaires, occupants, permis, stationnement, energie, urbanisme.
        Relire ensuite `GET /v1/batiment?imb=…&donnees=…`.
      parameters:
        - schema:
            type: string
          in: query
          name: depuis
          required: false
          description: 'Curseur de l''appel précédent. Absent : depuis le début.'
        - schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 500
          in: query
          name: limite
          required: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - changements
                  - curseur
                  - encore
                properties:
                  changements:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        imb:
                          type: string
                        donnee:
                          type: string
                          enum:
                            - decisionnaires
                            - caracteristiques
                            - fibre
                            - copropriete
                            - proprietaires
                            - gestionnaires
                            - occupants
                            - permis
                            - stationnement
                            - energie
                            - urbanisme
                        detecte_le:
                          type: string
                  curseur:
                    type:
                      - 'null'
                      - string
                  encore:
                    type: boolean
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - error
                  - request_id
                properties:
                  error:
                    type: object
                    additionalProperties: false
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  request_id:
                    type: string
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - error
                  - request_id
                properties:
                  error:
                    type: object
                    additionalProperties: false
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  request_id:
                    type: string
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - error
                  - request_id
                properties:
                  error:
                    type: object
                    additionalProperties: false
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  request_id:
                    type: string
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - error
                  - request_id
                properties:
                  error:
                    type: object
                    additionalProperties: false
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  request_id:
                    type: string
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - error
                  - request_id
                properties:
                  error:
                    type: object
                    additionalProperties: false
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  request_id:
                    type: string
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - error
                  - request_id
                properties:
                  error:
                    type: object
                    additionalProperties: false
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  request_id:
                    type: string
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        Clé API partenaire (`upk_live_…` / `upk_test_…`). Alias MCP :
        `Authorization: Bearer upk_…`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.