> ## 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.

# Bâtiments suivis

> Liste paginée par code IMB : repasser `suivant` dans `apres`.



## OpenAPI

````yaml /openapi.json get /v1/suivis
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/suivis:
    get:
      tags:
        - suivi
      summary: Bâtiments suivis
      description: 'Liste paginée par code IMB : repasser `suivant` dans `apres`.'
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 500
          in: query
          name: limite
          required: false
        - schema:
            type: string
          in: query
          name: apres
          required: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - suivis
                  - total
                  - suivant
                properties:
                  suivis:
                    type: array
                    items:
                      type: object
                      properties:
                        imb:
                          type: string
                        suivi_depuis:
                          type: string
                        dernier_controle:
                          type:
                            - 'null'
                            - string
                        erreur:
                          type:
                            - 'null'
                            - string
                  total:
                    type: integer
                  suivant:
                    type:
                      - 'null'
                      - string
        '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.