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

# Classified notification



## OpenAPI

````yaml /immoteur-api-public-v1.spec.yaml webhook classified-notification
openapi: 3.1.0
info:
  title: Immoteur Public API
  version: 1.1.0
  description: >-
    Public API for the Immoteur service.


    ## Authentication

    Use a **Personal Access Token** from your Immoteur dashboard and send it in
    the `Authorization` header:


    ```

    Authorization: Bearer YOUR_TOKEN_HERE

    ```


    ### cURL example

    ```bash

    curl -sS https://api.immoteur.com/public/v1/auth \
      -H "Authorization: Bearer $IMMOTEUR_TOKEN"
    ```


    ## Environments

    - **Production:** `https://api.immoteur.com/public/v1`


    ## Errors & Rate Limiting

    - `400 Bad Request`: malformed request or invalid syntax.

    - `401 Unauthorized`: missing or invalid token.

    - `403 Forbidden`: token valid but not permitted for this resource.

    - `429 Too Many Requests`: back off and retry with exponential delay.

    - `422 Validation Error`: payload is syntactically correct but fails
    validation.


    ## Pagination

    - Requests specify `page` (1..500). Responses include `page`, `nextPage`,
    `perPage`, `total`, `totalPages`.


    ## Data Access Limits

    The `meta.dataAccessLimit` block shows **implicit filters** tied to your
    plan (e.g., whitelisted departments/SIREN/SIRET). Your effective result set
    equals **your filters ∩ requested filters**.


    ## Using AI/LLMs

    - Always include the `Authorization` header.

    - Prefer explicit filters (departments, INSEE, postcodes) with **existing**
    French codes/names.

    - Follow the examples below as canonical payload shapes.


    ## Contact & Docs

    - Website: https://immoteur.com

    - Support: Use your customer portal or contact listed on the website.
  contact:
    url: https://immoteur.com
    name: Immoteur
    email: support@immoteur.com
servers:
  - url: https://api.immoteur.com/public/v1
    description: Production server
security:
  - BearerAuth: []
tags:
  - name: Info
    description: Token/account info
  - name: Property
    description: Property operations
  - name: Classified
    description: Classified operations
  - name: Issue
    description: User-submitted issue reports
externalDocs:
  description: Full product documentation
  url: https://docs.immoteur.com
paths: {}
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Personal Access Token
      description: |-
        Send your Immoteur Personal Access Token in the `Authorization` header:
        `Authorization: Bearer <token>`

        You can create and manage your Personal Access Tokens here:
        https://immoteur.com/dashboard/settings
                                    status:
                                        current: available

````