{"openapi":"3.0.0","paths":{"/ping":{"get":{"operationId":"AppController_ping","parameters":[],"responses":{"200":{"description":"pong"}},"security":[],"summary":"Liveness — process up","tags":["app"]}},"/health":{"get":{"operationId":"AppController_health","parameters":[],"responses":{"200":{"description":"Service joignable"}},"security":[],"summary":"Probe infra (Railway / load balancer)","tags":["app"]}},"/status":{"get":{"operationId":"AppController_status","parameters":[],"responses":{"200":{"description":"Toujours 200 ; lire body.status / acts / infrastructure"}},"security":[],"summary":"Status page — infra + détail par thème","tags":["app"]}},"/v1/me":{"get":{"operationId":"AppController_me","parameters":[],"responses":{"200":{"description":"Clé résolue"},"401":{"description":"Non authentifié"}},"security":[{"bearer":[]}],"summary":"Infos de la clé API authentifiée","tags":["app"]}},"/v1/webhooks/ping":{"post":{"operationId":"WebhooksController_ping","parameters":[],"responses":{"200":{"description":"Ping émis (ou tentative)"},"400":{"description":"webhook_url / webhook_secret non configurés"},"401":{"description":"Non authentifié"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Émettre system.ping vers l’URL webhook configurée","tags":["webhooks"]}},"/v1/capital-deposits":{"post":{"operationId":"CapitalDepositsController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","example":"idem-capital-deposit-001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCapitalDepositDto"}}}},"responses":{"200":{"description":"Rejeu idempotent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapitalDepositResponseDto"}}}},"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapitalDepositResponseDto"}}}},"400":{"description":"Body ou Idempotency-Key invalide"},"401":{"description":"Non authentifié"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Créer un dossier dépôt de capital (idempotent)","tags":["capital-deposits"]},"get":{"operationId":"CapitalDepositsController_list","parameters":[{"name":"cursor","required":false,"in":"query","description":"Curseur de pagination (opaque)","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Nombre max d’éléments (1–100)","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapitalDepositListResponseDto"}}}},"401":{"description":"Non authentifié"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Lister les dossiers dépôt de capital du partenaire","tags":["capital-deposits"]}},"/v1/capital-deposits/{id}":{"patch":{"operationId":"CapitalDepositsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCapitalDepositDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapitalDepositResponseDto"}}}},"400":{"description":"Body invalide"},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Enrichir data et/ou étendre acts d’un dossier dépôt de capital","tags":["capital-deposits"]},"get":{"operationId":"CapitalDepositsController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapitalDepositResponseDto"}}}},"401":{"description":"Non authentifié"},"404":{"description":"Introuvable (ou autre partenaire)"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Récupérer un dossier dépôt de capital par id","tags":["capital-deposits"]}},"/v1/capital-deposits/{id}/documents":{"post":{"operationId":"CapitalDepositsController_addDocument","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","example":"idem-capdep-doc-001"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["kind","file"],"properties":{"kind":{"type":"string","enum":["articles_of_association","shareholder_id","proof_of_funds","bank_details","register_extract","deposit_certificate","other"]},"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Rejeu idempotent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapitalDepositDocumentResponseDto"}}}},"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapitalDepositDocumentResponseDto"}}}},"400":{"description":"Body invalide"},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Uploader un document (idempotent)","tags":["capital-deposits"]},"get":{"operationId":"CapitalDepositsController_listDocuments","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CapitalDepositDocumentResponseDto"}}}}},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Lister les documents d’un dossier dépôt de capital","tags":["capital-deposits"]}},"/v1/real-estate":{"post":{"operationId":"RealEstateController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","example":"idem-real-estate-001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRealEstateDto"}}}},"responses":{"200":{"description":"Rejeu idempotent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealEstateResponseDto"}}}},"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealEstateResponseDto"}}}},"400":{"description":"Body ou Idempotency-Key invalide"},"401":{"description":"Non authentifié"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Créer un dossier immobilier (idempotent)","tags":["real-estate"]},"get":{"operationId":"RealEstateController_list","parameters":[{"name":"cursor","required":false,"in":"query","description":"Curseur de pagination (opaque)","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Nombre max d’éléments (1–100)","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealEstateListResponseDto"}}}},"401":{"description":"Non authentifié"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Lister les dossiers immobiliers du partenaire","tags":["real-estate"]}},"/v1/real-estate/{id}":{"patch":{"operationId":"RealEstateController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRealEstateDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealEstateResponseDto"}}}},"400":{"description":"Body invalide"},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Enrichir data et/ou étendre acts d’un dossier immobilier","tags":["real-estate"]},"get":{"operationId":"RealEstateController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealEstateResponseDto"}}}},"401":{"description":"Non authentifié"},"404":{"description":"Introuvable (ou autre partenaire)"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Récupérer un dossier immobilier par id","tags":["real-estate"]}},"/v1/real-estate/{id}/documents":{"post":{"operationId":"RealEstateController_addDocument","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","example":"idem-re-doc-001"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["kind","file"],"properties":{"kind":{"type":"string","enum":["id_seller","id_buyer","title_deed","diagnostics","co_ownership","puv_signed_copy","mortgage_offer","other"]},"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Rejeu idempotent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealEstateDocumentResponseDto"}}}},"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealEstateDocumentResponseDto"}}}},"400":{"description":"Body invalide"},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Uploader un document vers Scaleway Object Storage (idempotent)","tags":["real-estate"]},"get":{"operationId":"RealEstateController_listDocuments","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RealEstateDocumentResponseDto"}}}}},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Lister les documents d’un dossier immobilier","tags":["real-estate"]}},"/v1/succession":{"post":{"operationId":"SuccessionController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","example":"idem-succession-001"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSuccessionDto"}}}},"responses":{"200":{"description":"Rejeu idempotent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessionResponseDto"}}}},"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessionResponseDto"}}}},"400":{"description":"Body ou Idempotency-Key invalide"},"401":{"description":"Non authentifié"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Créer un dossier succession (idempotent)","tags":["succession"]},"get":{"operationId":"SuccessionController_list","parameters":[{"name":"cursor","required":false,"in":"query","description":"Curseur de pagination (opaque)","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Nombre max d’éléments (1–100)","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessionListResponseDto"}}}},"401":{"description":"Non authentifié"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Lister les dossiers succession du partenaire","tags":["succession"]}},"/v1/succession/{id}":{"patch":{"operationId":"SuccessionController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSuccessionDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessionResponseDto"}}}},"400":{"description":"Body invalide"},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Enrichir data et/ou étendre acts d’un dossier succession","tags":["succession"]},"get":{"operationId":"SuccessionController_findOne","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessionResponseDto"}}}},"401":{"description":"Non authentifié"},"404":{"description":"Introuvable (ou autre partenaire)"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Récupérer un dossier succession par id","tags":["succession"]}},"/v1/succession/{id}/documents":{"post":{"operationId":"SuccessionController_addDocument","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","example":"idem-succ-doc-001"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["kind","file"],"properties":{"kind":{"type":"string","enum":["civil_status","family_situation","last_wishes","real_estate","financial","business","liabilities","tax","power_of_attorney","other"]},"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Rejeu idempotent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessionDocumentResponseDto"}}}},"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessionDocumentResponseDto"}}}},"400":{"description":"Body invalide"},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Uploader un document vers Scaleway Object Storage (idempotent)","tags":["succession"]},"get":{"operationId":"SuccessionController_listDocuments","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SuccessionDocumentResponseDto"}}}}},"401":{"description":"Non authentifié"},"404":{"description":"Dossier introuvable"},"429":{"description":"Rate limit dépassé"}},"security":[{"bearer":[]}],"summary":"Lister les documents d’un dossier succession","tags":["succession"]}}},"info":{"title":"Allaw Partner API","description":"API partenaires Allaw.\n\nAuth : clique **Authorize**, colle uniquement ta clé :\n`sk_live_…`\n\n(Swagger ajoute `Bearer` automatiquement.)","version":"1.0","contact":{}},"tags":[],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"API Key","type":"http","description":"Colle uniquement sk_live_… (sans le mot Bearer)"}},"schemas":{"CompanyDto":{"type":"object","properties":{"legalName":{"type":"string","description":"Raison sociale de la société","example":"Acme SAS"},"siren":{"type":"string","description":"Numéro SIREN (9 chiffres)","example":"123456789"},"legalForm":{"type":"string","description":"Forme juridique","example":"SAS"}},"required":["legalName","siren"]},"ShareholderDto":{"type":"object","properties":{"name":{"type":"string","description":"Nom du souscripteur","example":"Alice Martin"},"contributionAmount":{"type":"number","description":"Montant de la souscription","example":5000},"contributionType":{"type":"string","description":"Nature de l’apport","enum":["cash","in_kind"],"example":"cash"}},"required":["name","contributionAmount","contributionType"]},"WireNotificationDto":{"type":"object","properties":{"amount":{"type":"number","example":5000},"currency":{"type":"string","example":"EUR"},"executedAt":{"type":"string","description":"Date/heure d’exécution du virement (ISO 8601)","example":"2026-07-22T10:00:00.000Z"},"reference":{"type":"string","description":"Référence bancaire du virement","example":"VIR-ACME-001"}},"required":["amount","currency","executedAt"]},"CapitalDepositDataDto":{"type":"object","properties":{"amount":{"type":"number","description":"Montant total du dépôt de capital","example":10000},"currency":{"type":"string","description":"Devise ISO 4217","example":"EUR"},"company":{"$ref":"#/components/schemas/CompanyDto"},"shareholders":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ShareholderDto"}},"depositDate":{"type":"string","description":"Date du dépôt (ISO 8601 date)","example":"2026-07-21"},"purpose":{"type":"string","description":"Objet / motif du dépôt","example":"Constitution de société"},"wireNotifications":{"description":"Virements émis (enrichi via PATCH)","type":"array","items":{"$ref":"#/components/schemas/WireNotificationDto"}}},"required":["amount","currency","company","shareholders","depositDate"]},"CreateCapitalDepositDto":{"type":"object","properties":{"acts":{"type":"array","minItems":1,"example":["capital_deposit"],"items":{"type":"string","enum":["capital_deposit"]}},"data":{"$ref":"#/components/schemas/CapitalDepositDataDto"},"partnerCaseRef":{"type":"string","description":"Référence dossier côté partenaire (CRM)","example":"swan-capdep-42"}},"required":["acts","data"]},"CapitalDepositActResponseDto":{"type":"object","properties":{"type":{"type":"string","enum":["capital_deposit"]},"status":{"type":"string","enum":["created","processing","awaiting_notary_validation","completed","rejected"],"example":"created"}},"required":["type","status"]},"CapitalDepositResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"partner_case_ref":{"type":"object","nullable":true,"description":"Référence dossier côté partenaire (CRM)","example":"swan-capdep-42"},"target_organization_id":{"type":"object","nullable":true,"description":"Étude Allaw liée à la clé API (`default_organization_id`) — lecture seule","example":"org_3EDD2GKNG71h5PXAk266iDk25uK"},"acts":{"type":"array","items":{"$ref":"#/components/schemas/CapitalDepositActResponseDto"}},"data":{"$ref":"#/components/schemas/CapitalDepositDataDto"},"created_at":{"type":"string","example":"2026-07-22T12:00:00.000Z"},"updated_at":{"type":"string","example":"2026-07-22T12:00:00.000Z"}},"required":["id","acts","data","created_at","updated_at"]},"CapitalDepositListResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CapitalDepositResponseDto"}},"next_cursor":{"type":"object","nullable":true}},"required":["data","next_cursor"]},"UpdateCapitalDepositDataDto":{"type":"object","properties":{"amount":{"type":"number","description":"Montant total du dépôt de capital","example":10000},"currency":{"type":"string","description":"Devise ISO 4217","example":"EUR"},"company":{"$ref":"#/components/schemas/CompanyDto"},"shareholders":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ShareholderDto"}},"depositDate":{"type":"string","description":"Date du dépôt (ISO 8601 date)","example":"2026-07-21"},"purpose":{"type":"string","description":"Objet / motif du dépôt","example":"Constitution de société"},"wireNotifications":{"description":"Virements émis (enrichi via PATCH)","type":"array","items":{"$ref":"#/components/schemas/WireNotificationDto"}}}},"UpdateCapitalDepositDto":{"type":"object","properties":{"acts":{"type":"array","minItems":1,"description":"Liste complète désirée des types d’actes (union avec l’existant)","example":["capital_deposit"],"items":{"type":"string","enum":["capital_deposit"]}},"data":{"description":"Fusion shallow top-level avec data existante","allOf":[{"$ref":"#/components/schemas/UpdateCapitalDepositDataDto"}]}}},"CapitalDepositDocumentResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"capital_deposit_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["articles_of_association","shareholder_id","proof_of_funds","bank_details","register_extract","deposit_certificate","other"]},"filename":{"type":"string"},"url":{"type":"string","description":"URL Object Storage du fichier stocké"},"content_type":{"type":"object"},"status":{"type":"string","example":"received"},"created_at":{"type":"string"}},"required":["id","capital_deposit_id","kind","filename","url","status","created_at"]},"PostalAddressDto":{"type":"object","properties":{"street":{"type":"string","example":"12 rue de Rivoli"},"postalCode":{"type":"string","example":"75001"},"city":{"type":"string","example":"Paris"}},"required":["street","postalCode","city"]},"PropertyDto":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/PostalAddressDto"},"type":{"type":"string","enum":["apartment","house","land","parking","other"],"example":"apartment"},"priceAmount":{"type":"number","example":450000},"priceCurrency":{"type":"string","example":"EUR"}},"required":["address"]},"PartyDto":{"type":"object","properties":{"fullName":{"type":"string","example":"Jean Martin"},"email":{"type":"string","example":"jean.martin@example.com"},"phone":{"type":"string","example":"0612345678"}},"required":["fullName","email"]},"RealEstateDataDto":{"type":"object","properties":{"property":{"$ref":"#/components/schemas/PropertyDto"},"sellers":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/PartyDto"}},"buyers":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/PartyDto"}},"targetSignatureDate":{"type":"string","example":"2026-09-15"},"purpose":{"type":"string","example":"Cession lot 12 — résidence Les Lilas"}},"required":["property","sellers","buyers"]},"CreateRealEstateDto":{"type":"object","properties":{"acts":{"type":"array","minItems":1,"example":["unilateral_sale_promise"],"items":{"type":"string","enum":["unilateral_sale_promise","property_deed","sale_agreement"]}},"data":{"$ref":"#/components/schemas/RealEstateDataDto"},"partnerCaseRef":{"type":"string","description":"Référence dossier côté partenaire (CRM)","example":"crm-sale-42"}},"required":["acts","data"]},"RealEstateActResponseDto":{"type":"object","properties":{"type":{"type":"string","enum":["unilateral_sale_promise","property_deed","sale_agreement"]},"status":{"type":"string","enum":["created","processing","awaiting_notary_validation","completed","rejected"],"example":"created"}},"required":["type","status"]},"RealEstateResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"partner_case_ref":{"type":"object","nullable":true,"description":"Référence dossier côté partenaire (CRM)","example":"crm-sale-42"},"target_organization_id":{"type":"object","nullable":true,"description":"Étude Allaw liée à la clé API (`default_organization_id`) — lecture seule","example":"org_3EDD2GKNG71h5PXAk266iDk25uK"},"acts":{"type":"array","items":{"$ref":"#/components/schemas/RealEstateActResponseDto"}},"data":{"$ref":"#/components/schemas/RealEstateDataDto"},"created_at":{"type":"string","example":"2026-07-22T12:00:00.000Z"},"updated_at":{"type":"string","example":"2026-07-22T12:00:00.000Z"}},"required":["id","acts","data","created_at","updated_at"]},"RealEstateListResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RealEstateResponseDto"}},"next_cursor":{"type":"object","nullable":true}},"required":["data","next_cursor"]},"UpdateRealEstateDataDto":{"type":"object","properties":{"property":{"$ref":"#/components/schemas/PropertyDto"},"sellers":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/PartyDto"}},"buyers":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/PartyDto"}},"targetSignatureDate":{"type":"string","example":"2026-09-15"},"purpose":{"type":"string","example":"Cession lot 12 — résidence Les Lilas"}}},"UpdateRealEstateDto":{"type":"object","properties":{"acts":{"type":"array","minItems":1,"description":"Liste complète désirée des types d’actes (union avec l’existant)","example":["unilateral_sale_promise","property_deed"],"items":{"type":"string","enum":["unilateral_sale_promise","property_deed","sale_agreement"]}},"data":{"description":"Fusion shallow top-level avec data existante","allOf":[{"$ref":"#/components/schemas/UpdateRealEstateDataDto"}]}}},"RealEstateDocumentResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"real_estate_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["id_seller","id_buyer","title_deed","diagnostics","co_ownership","puv_signed_copy","mortgage_offer","other"]},"filename":{"type":"string"},"url":{"type":"string","description":"URL Scaleway Object Storage du fichier stocké"},"content_type":{"type":"object"},"status":{"type":"string","example":"received"},"created_at":{"type":"string"}},"required":["id","real_estate_id","kind","filename","url","status","created_at"]},"RequesterDto":{"type":"object","properties":{"fullName":{"type":"string","example":"Marie Dupont"},"capacity":{"type":"string","description":"Qualité du demandeur","example":"heir","enum":["heir","notary","lawyer","other"]},"email":{"type":"string","example":"requester@example.com"},"phone":{"type":"string","example":"0612345678"},"birthDate":{"type":"string","example":"1955-06-20"},"birthPlace":{"type":"string","example":"Lyon"}},"required":["fullName","capacity","email"]},"DeceasedPersonDto":{"type":"object","properties":{"fullName":{"type":"string","example":"Jean Dupont"},"birthDate":{"type":"string","example":"1950-03-12"},"birthPlace":{"type":"string","example":"Paris"},"deathDate":{"type":"string","example":"2026-01-15","description":"Date de décès"},"lastAddress":{"type":"string","example":"12 rue de Rivoli, 75001 Paris"}},"required":["fullName"]},"HeirDto":{"type":"object","properties":{"fullName":{"type":"string","example":"Jean Dupont"},"birthDate":{"type":"string","example":"1950-03-12"},"birthPlace":{"type":"string","example":"Paris"},"relationship":{"type":"string","description":"Lien avec le défunt","example":"child","enum":["spouse","child","parent","sibling","other"]},"email":{"type":"string","example":"heir@example.com"}},"required":["fullName"]},"SuccessionDataDto":{"type":"object","properties":{"requester":{"description":"Seul bloc obligatoire à la création","allOf":[{"$ref":"#/components/schemas/RequesterDto"}]},"deceased":{"$ref":"#/components/schemas/DeceasedPersonDto"},"heirs":{"type":"array","items":{"$ref":"#/components/schemas/HeirDto"}},"purpose":{"type":"string","description":"Objet de la demande d’acte de notoriété","example":"Succession — ouverture des comptes bancaires"},"jurisdictionPostalCode":{"type":"string","description":"Code postal du ressort","example":"75001"}},"required":["requester"]},"CreateSuccessionDto":{"type":"object","properties":{"acts":{"type":"array","minItems":1,"example":["notoriety"],"items":{"type":"string","enum":["notoriety","inventory","property_attestation","partition","ownership_certificate"]}},"data":{"$ref":"#/components/schemas/SuccessionDataDto"},"partnerCaseRef":{"type":"string","description":"Référence dossier côté partenaire (CRM)","example":"crm-succession-42"}},"required":["acts","data"]},"SuccessionActResponseDto":{"type":"object","properties":{"type":{"type":"string","enum":["notoriety","inventory","property_attestation","partition","ownership_certificate"]},"status":{"type":"string","enum":["created","processing","awaiting_notary_validation","completed","rejected"],"example":"created"}},"required":["type","status"]},"SuccessionResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"partner_case_ref":{"type":"object","nullable":true,"description":"Référence dossier côté partenaire (CRM)","example":"crm-succession-42"},"target_organization_id":{"type":"object","nullable":true,"description":"Étude Allaw liée à la clé API (`default_organization_id`) — lecture seule","example":"org_3EDD2GKNG71h5PXAk266iDk25uK"},"acts":{"type":"array","items":{"$ref":"#/components/schemas/SuccessionActResponseDto"}},"data":{"$ref":"#/components/schemas/SuccessionDataDto"},"created_at":{"type":"string","example":"2026-07-22T12:00:00.000Z"},"updated_at":{"type":"string","example":"2026-07-22T12:00:00.000Z"}},"required":["id","acts","data","created_at","updated_at"]},"SuccessionListResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SuccessionResponseDto"}},"next_cursor":{"type":"object","nullable":true}},"required":["data","next_cursor"]},"UpdateSuccessionDataDto":{"type":"object","properties":{"requester":{"description":"Seul bloc obligatoire à la création","allOf":[{"$ref":"#/components/schemas/RequesterDto"}]},"deceased":{"$ref":"#/components/schemas/DeceasedPersonDto"},"heirs":{"type":"array","items":{"$ref":"#/components/schemas/HeirDto"}},"purpose":{"type":"string","description":"Objet de la demande d’acte de notoriété","example":"Succession — ouverture des comptes bancaires"},"jurisdictionPostalCode":{"type":"string","description":"Code postal du ressort","example":"75001"}}},"UpdateSuccessionDto":{"type":"object","properties":{"acts":{"type":"array","minItems":1,"description":"Liste complète désirée des types d’actes (union avec l’existant)","example":["notoriety","partition"],"items":{"type":"string","enum":["notoriety","inventory","property_attestation","partition","ownership_certificate"]}},"data":{"description":"Fusion shallow top-level avec data existante","allOf":[{"$ref":"#/components/schemas/UpdateSuccessionDataDto"}]}}},"SuccessionDocumentResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"succession_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["civil_status","family_situation","last_wishes","real_estate","financial","business","liabilities","tax","power_of_attorney","other"]},"filename":{"type":"string"},"url":{"type":"string","description":"URL Scaleway Object Storage du fichier stocké"},"content_type":{"type":"object"},"status":{"type":"string","example":"received"},"created_at":{"type":"string"}},"required":["id","succession_id","kind","filename","url","status","created_at"]}}},"security":[{"bearer":[]}]}