Maison du Pré-état daté — Documentation

Integrate "Pré-état daté" creation & lifecycle

Welcome! This documentation explains how to integrate Maison du Pré-état daté into your workflow to create and manage pré-état daté requests from your systems.

You need a Premium or Syndic account to access the API.
Questions? → contact@pre-etat.date

Who is this for?

The Maison du Pré-état daté API is designed for: - Real‑estate transaction software vendors who want to embed pré‑état daté ordering in their back‑office. - Websites and mobile apps that need to let end‑users request a pré‑état daté in a few clicks. - Systems integrators connecting notary/syndic workflows with automated document collection and notifications.

Public API endpoints

  • Primary host (recommended): https://api.maison-du-pre-etat-date.fr
    Use this hostname in production integrations.

Architecture at a glance

sequenceDiagram autonumber participant Client participant API as PRE-ETAT.DATE API participant Syndic as Syndic Extranet participant Callback as Your Webhook Client->>API: POST /account/auth (email, password, X-Auth-Key) API-->>Client: 200 { access_token } Client->>API: POST /order/ (Bearer token, payload) API->>Syndic: Fetch/submit documents (method: extranet) Syndic-->>API: Status updates, documents API-->>Client: 200 { orderid, state: confirmed } API->>Callback: POST webhook (status: received|waiting|done) Callback-->>API: 2xx OK (idempotent)

Contents

  1. Accounts & Activation
  2. Authentication
  3. Transactions
  4. Webhooks & Notifications

Quickstart (cURL)

1 "Get access token"

# Base URL (production)
BASE_URL="https://api.maison-du-pre-etat-date.fr"

# Obtain JWT access token
curl -s -X POST "$BASE_URL/account/auth" \
  -H "Content-Type: application/json" \
  -H "X-Auth-Key: $API_KEY" \
  -d '{
    "email": "john@example.com",
    "password": "secret"
  }' \
  | jq -r '.payload.access_token' > token.txt

echo "Access token saved to token.txt"

2 "Get access token"

TOKEN=$(cat token.txt)

curl -X POST "$BASE_URL/order/" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Auth-Key: $API_KEY" \
  -d @transaction.json

# transaction.json should contain a valid order payload, see Transaction