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

# Suivre une demande de contact

> État canal par canal. Relire toutes les 10 à 30 secondes tant que `statut` vaut `en_cours`.



## OpenAPI

````yaml /openapi.json get /v1/contacts/{id}
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/contacts/{id}:
    get:
      tags:
        - contacts
      summary: Suivre une demande de contact
      description: >-
        État canal par canal. Relire toutes les 10 à 30 secondes tant que
        `statut` vaut `en_cours`.
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - statut
                  - cible
                  - canaux
                  - credits
                  - cree_le
                  - termine_le
                properties:
                  id:
                    type: string
                  statut:
                    type: string
                    enum:
                      - en_cours
                      - termine
                    description: >-
                      `termine` quand chaque canal est trouvé, introuvable ou en
                      échec.
                  cible:
                    type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - entreprise
                          - dirigeant
                      siren:
                        type:
                          - 'null'
                          - string
                      raison_sociale:
                        type:
                          - 'null'
                          - string
                      nom:
                        type:
                          - 'null'
                          - string
                      prenom:
                        type:
                          - 'null'
                          - string
                      qualite:
                        type:
                          - 'null'
                          - string
                      role_batiment:
                        type: string
                  canaux:
                    type: array
                    items:
                      type: object
                      required:
                        - canal
                        - statut
                        - valeur
                      properties:
                        canal:
                          type: string
                          enum:
                            - standard
                            - email_pro
                            - linkedin
                            - email_perso
                            - mobile
                        statut:
                          type: string
                          enum:
                            - en_cours
                            - trouve
                            - introuvable
                            - echec
                        valeur:
                          type:
                            - 'null'
                            - string
                  credits:
                    type:
                      - 'null'
                      - object
                    description: >-
                      Pack de crédits contact de l'organisation. null si
                      illimité.
                    properties:
                      pack:
                        type: integer
                        description: Pack du contrat + packs complémentaires.
                      consommes:
                        type: integer
                      restants:
                        type: integer
                  cree_le:
                    type: string
                  termine_le:
                    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
        '402':
          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
        '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.