> ## Documentation Index > Fetch the complete documentation index at: https://developers.marko.fr/llms.txt > Use this file to discover all available pages before exploring further. # Créer ou mettre à jour une SPV externe > Upsert synchrone par identifiant partenaire. Une ressource MARKO supprimée logiquement est restaurée avec le même UUID. existing_marko_id permet de lier explicitement une SPV existante lors du premier envoi. ## OpenAPI ````yaml https://partner-api.marko.fr/v1/openapi.json put /spvs/external/{external_id} openapi: 3.1.0 info: title: MARKO External Partner API version: v1 description: >- Stable external API contract for the live environment. Authentication flow for partner integrations: 1. Generate an API key from the MARKO entity admin API section. 2. Keep the raw API secret server-side and use it only to sign `POST /v1/auth/token`. 3. Build the canonical message `MARKO-EXTERNAL-API-TOKEN-V1\n{key_id}\n{timestamp}\n{nonce}`. 4. Sign that message with HMAC-SHA256 and send the hex signature with `key_id`, `timestamp` and `nonce`. 5. Use the returned short-lived bearer on business endpoints as `Authorization: Bearer `. The raw API secret must never be sent on business endpoints. This public contract intentionally excludes beta endpoints. servers: - url: https://partner-api.marko.fr/v1 security: - BearerAuth: [] externalDocs: description: Download the matching Postman collection. url: /v1/postman.json paths: /spvs/external/{external_id}: put: tags: - spvs summary: Créer ou mettre à jour une SPV externe description: >- Upsert synchrone par identifiant partenaire. Une ressource MARKO supprimée logiquement est restaurée avec le même UUID. existing_marko_id permet de lier explicitement une SPV existante lors du premier envoi. operationId: spvs_external_upsert parameters: - in: path name: external_id required: true schema: type: string pattern: ^[A-Za-z0-9_~-][A-Za-z0-9._:~-]{0,254}$ minLength: 1 maxLength: 255 example: CF-SPV-001 - in: header name: X-Request-ID required: false description: >- Partner-generated correlation identifier echoed in logs and error payloads. schema: type: string example: marko-spvs-external-upsert - in: header name: Idempotency-Key required: true description: >- Required for every write, including environments where replay deduplication is disabled. Reuse the same value when retrying the same logical write and use a new value for a different write. schema: type: string maxLength: 255 pattern: ^[!-~]+$ requestBody: required: true content: application/json: schema: additionalProperties: false properties: existing_marko_id: anyOf: - type: string format: uuid - type: 'null' default: null title: Existing Marko Id name: maxLength: 255 minLength: 1 title: Name type: string siren: anyOf: - type: string - type: 'null' default: null title: Siren forme_juridique: anyOf: - type: string maxLength: 255 - type: 'null' default: null title: Forme Juridique capital_social: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Capital Social montage: anyOf: - description: Type de montage financier du SPV. enum: - dette_senior - mezzanine - equity - mix title: MontageFinancier type: string - type: 'null' default: null date_creation: anyOf: - format: date type: string - type: 'null' default: null title: Date Creation adresse: anyOf: - maxLength: 500 type: string - type: 'null' default: null title: Adresse region: anyOf: - type: string maxLength: 255 - type: 'null' default: null title: Region beneficiaire_effectif: anyOf: - maxLength: 500 type: string - type: 'null' default: null title: Beneficiaire Effectif fond_id: anyOf: - type: string format: uuid - type: 'null' default: null title: Fond Id required: - name title: ExternalSPVUpsertRequest type: object example: name: SPV Paris 19 forme_juridique: SAS siren: '123456782' adresse: 10 rue de la République, 75019 Paris responses: '200': description: Additional successful response content: application/json: schema: properties: external_id: title: External Id type: string marko_id: format: uuid title: Marko Id type: string outcome: enum: - created - updated - noop - restored - bound title: Outcome type: string resource: properties: name: title: Name type: string siren: anyOf: - type: string - type: 'null' default: null title: Siren forme_juridique: anyOf: - type: string - type: 'null' default: null title: Forme Juridique capital_social: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Capital Social montage: anyOf: - description: Type de montage financier du SPV. enum: - dette_senior - mezzanine - equity - mix title: MontageFinancier type: string - type: 'null' default: null date_creation: anyOf: - format: date type: string - type: 'null' default: null title: Date Creation identite_entreprise: anyOf: - description: >- Selected registry identity, bound to the company it describes. properties: siren: pattern: ^\d{9}$ title: Siren type: string siret: anyOf: - type: string - type: 'null' default: null title: Siret representant_legal: anyOf: - description: >- A single dirigeant (director/officer) of the company. properties: nom: anyOf: - type: string - type: 'null' default: null title: Nom prenom: anyOf: - type: string - type: 'null' default: null title: Prenom qualite: anyOf: - type: string - type: 'null' default: null title: Qualite date_naissance: anyOf: - type: string - type: 'null' default: null title: Date Naissance denomination: anyOf: - type: string - type: 'null' default: null title: Denomination siren: anyOf: - type: string - type: 'null' default: null title: Siren personne_morale: anyOf: - type: boolean - type: 'null' default: null title: Personne Morale qualites: items: type: string title: Qualites type: array date_prise_de_poste: anyOf: - type: string - type: 'null' default: null title: Date Prise De Poste adresse: anyOf: - properties: adresse_ligne_1: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 1 adresse_ligne_2: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 2 adresse_ligne_3: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 3 complement_adresse: anyOf: - type: string - type: 'null' default: null title: Complement Adresse code_postal: anyOf: - type: string - type: 'null' default: null title: Code Postal ville: anyOf: - type: string - type: 'null' default: null title: Ville pays: anyOf: - type: string - type: 'null' default: null title: Pays code_pays: anyOf: - type: string - type: 'null' default: null title: Code Pays latitude: anyOf: - type: number - type: 'null' default: null title: Latitude longitude: anyOf: - type: number - type: 'null' default: null title: Longitude title: SIRENAdresse type: object - type: 'null' default: null forme_juridique: anyOf: - type: string - type: 'null' default: null title: Forme Juridique title: SIRENDirigeant type: object - type: 'null' default: null presidents: anyOf: - items: description: >- A single dirigeant (director/officer) of the company. properties: nom: anyOf: - type: string - type: 'null' default: null title: Nom prenom: anyOf: - type: string - type: 'null' default: null title: Prenom qualite: anyOf: - type: string - type: 'null' default: null title: Qualite date_naissance: anyOf: - type: string - type: 'null' default: null title: Date Naissance denomination: anyOf: - type: string - type: 'null' default: null title: Denomination siren: anyOf: - type: string - type: 'null' default: null title: Siren personne_morale: anyOf: - type: boolean - type: 'null' default: null title: Personne Morale qualites: items: type: string title: Qualites type: array date_prise_de_poste: anyOf: - type: string - type: 'null' default: null title: Date Prise De Poste adresse: anyOf: - properties: adresse_ligne_1: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 1 adresse_ligne_2: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 2 adresse_ligne_3: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 3 complement_adresse: anyOf: - type: string - type: 'null' default: null title: Complement Adresse code_postal: anyOf: - type: string - type: 'null' default: null title: Code Postal ville: anyOf: - type: string - type: 'null' default: null title: Ville pays: anyOf: - type: string - type: 'null' default: null title: Pays code_pays: anyOf: - type: string - type: 'null' default: null title: Code Pays latitude: anyOf: - type: number - type: 'null' default: null title: Latitude longitude: anyOf: - type: number - type: 'null' default: null title: Longitude title: SIRENAdresse type: object - type: 'null' default: null forme_juridique: anyOf: - type: string - type: 'null' default: null title: Forme Juridique title: SIRENDirigeant type: object type: array - type: 'null' default: null title: Presidents beneficiaires_effectifs: anyOf: - items: description: >- Only the declared person's name; no private address or birth data. properties: nom: maxLength: 300 minLength: 1 title: Nom type: string prenom: anyOf: - maxLength: 300 type: string - type: 'null' default: null title: Prenom required: - nom title: SIRENBeneficiaireEffectif type: object type: array - type: 'null' default: null title: Beneficiaires Effectifs adresse_siege: anyOf: - properties: adresse_ligne_1: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 1 adresse_ligne_2: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 2 adresse_ligne_3: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 3 complement_adresse: anyOf: - type: string - type: 'null' default: null title: Complement Adresse code_postal: anyOf: - type: string - type: 'null' default: null title: Code Postal ville: anyOf: - type: string - type: 'null' default: null title: Ville pays: anyOf: - type: string - type: 'null' default: null title: Pays code_pays: anyOf: - type: string - type: 'null' default: null title: Code Pays latitude: anyOf: - type: number - type: 'null' default: null title: Latitude longitude: anyOf: - type: number - type: 'null' default: null title: Longitude title: SIRENAdresse type: object - type: 'null' default: null is_radiee: anyOf: - type: boolean - type: 'null' default: null title: Is Radiee entreprise_cessee: anyOf: - type: boolean - type: 'null' default: null title: Entreprise Cessee date_radiation: anyOf: - type: string - type: 'null' default: null title: Date Radiation date_cessation: anyOf: - type: string - type: 'null' default: null title: Date Cessation numero_tva_intracommunautaire: anyOf: - type: string - type: 'null' default: null title: Numero Tva Intracommunautaire date_cloture_exercice: anyOf: - type: string - type: 'null' default: null title: Date Cloture Exercice date_prochaine_cloture_exercice: anyOf: - type: string - type: 'null' default: null title: Date Prochaine Cloture Exercice date_cloture_exercice_exceptionnelle: anyOf: - type: string - type: 'null' default: null title: Date Cloture Exercice Exceptionnelle required: - siren title: SIRENCompanyIdentity type: object - type: 'null' default: null dirigeants: items: description: >- A single dirigeant (director/officer) of the company. properties: nom: anyOf: - type: string - type: 'null' default: null title: Nom prenom: anyOf: - type: string - type: 'null' default: null title: Prenom qualite: anyOf: - type: string - type: 'null' default: null title: Qualite date_naissance: anyOf: - type: string - type: 'null' default: null title: Date Naissance denomination: anyOf: - type: string - type: 'null' default: null title: Denomination siren: anyOf: - type: string - type: 'null' default: null title: Siren personne_morale: anyOf: - type: boolean - type: 'null' default: null title: Personne Morale qualites: items: type: string title: Qualites type: array date_prise_de_poste: anyOf: - type: string - type: 'null' default: null title: Date Prise De Poste adresse: anyOf: - properties: adresse_ligne_1: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 1 adresse_ligne_2: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 2 adresse_ligne_3: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 3 complement_adresse: anyOf: - type: string - type: 'null' default: null title: Complement Adresse code_postal: anyOf: - type: string - type: 'null' default: null title: Code Postal ville: anyOf: - type: string - type: 'null' default: null title: Ville pays: anyOf: - type: string - type: 'null' default: null title: Pays code_pays: anyOf: - type: string - type: 'null' default: null title: Code Pays latitude: anyOf: - type: number - type: 'null' default: null title: Latitude longitude: anyOf: - type: number - type: 'null' default: null title: Longitude title: SIRENAdresse type: object - type: 'null' default: null forme_juridique: anyOf: - type: string - type: 'null' default: null title: Forme Juridique title: SIRENDirigeant type: object maxItems: 500 title: Dirigeants type: array procedures_collectives: anyOf: - items: description: >- A collective proceeding reported by the company provider. properties: type: anyOf: - type: string - type: 'null' default: null title: Type date: anyOf: - type: string - type: 'null' default: null title: Date tribunal: anyOf: - type: string - type: 'null' default: null title: Tribunal title: SIRENProcedure type: object maxItems: 500 type: array - type: 'null' default: null title: Procedures Collectives organisation_pappers: anyOf: - additionalProperties: true type: object - type: 'null' default: null title: Organisation Pappers justice_pappers: anyOf: - additionalProperties: true type: object - type: 'null' default: null title: Justice Pappers id: format: uuid title: Id type: string entity_id: format: uuid title: Entity Id type: string fond_id: anyOf: - type: string format: uuid - type: 'null' default: null title: Fond Id adresse: anyOf: - type: string - type: 'null' default: null title: Adresse region: anyOf: - type: string - type: 'null' default: null title: Region beneficiaire_effectif: anyOf: - type: string - type: 'null' default: null title: Beneficiaire Effectif date_ag_annuelle: anyOf: - format: date type: string - type: 'null' default: null title: Date Ag Annuelle resultat_net_ag: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Resultat Net Ag pv_ag_document_id: anyOf: - type: string format: uuid - type: 'null' default: null title: Pv Ag Document Id procedure_collective: description: Statut de procédure collective. enum: - aucune - sauvegarde - redressement - liquidation title: ProcedureCollective type: string default: aucune litiges_en_cours: default: false title: Litiges En Cours type: boolean litiges_detail: anyOf: - type: string - type: 'null' default: null title: Litiges Detail contentieux_items: default: [] items: properties: id: anyOf: - type: string - type: 'null' default: null title: Id date_creation: anyOf: - format: date type: string - type: 'null' default: null title: Date Creation provision: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Provision montant_demande: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Montant Demande position: anyOf: - type: string - type: 'null' default: null title: Position partie_adverse: anyOf: - type: string - type: 'null' default: null title: Partie Adverse cabinet_avocat: anyOf: - type: string - type: 'null' default: null title: Cabinet Avocat juridiction: anyOf: - type: string - type: 'null' default: null title: Juridiction nature: anyOf: - type: string - type: 'null' default: null title: Nature detail: anyOf: - type: string - type: 'null' default: null title: Detail document_ids: items: type: string format: uuid maxItems: 20 title: Document Ids type: array title: SpvContentieuxItem type: object title: Contentieux Items type: array created_at: format: date-time title: Created At type: string updated_at: format: date-time title: Updated At type: string operations_count: anyOf: - type: integer - type: 'null' default: 0 title: Operations Count required: - name - id - entity_id - created_at - updated_at title: SPVResponse type: object taxonomy_additions: items: properties: parent_code: anyOf: - enum: - due_diligence - en_cours - en_recouvrement - termine type: string - type: 'null' default: null title: Parent Code code: title: Code type: string dimension: enum: - operation_status - investment_type - operation_type - asset_class - internal_status - operational_status - follow_up_category title: Dimension type: string display_label: title: Display Label type: string source_kind: enum: - marko - partner - entity title: Source Kind type: string source_display_name: title: Source Display Name type: string is_visible: title: Is Visible type: boolean is_active: title: Is Active type: boolean position: title: Position type: integer usage_count: default: 0 title: Usage Count type: integer label_editable: title: Label Editable type: boolean canonical_code: anyOf: - type: string - type: 'null' default: null title: Canonical Code icon_key: anyOf: - enum: - tag - briefcase - building - landmark - home - map - layers - shield - trending-up - calendar - circle-check - triangle-alert type: string - type: 'null' default: null title: Icon Key required: - code - dimension - display_label - source_kind - source_display_name - is_visible - is_active - position - label_editable title: EntityTaxonomyOptionResponse type: object title: Taxonomy Additions type: array request_id: title: Request Id type: string required: - external_id - marko_id - outcome - resource - request_id title: ExternalSPVSyncUpsertResponse type: object '201': description: Successful response content: application/json: schema: properties: external_id: title: External Id type: string marko_id: format: uuid title: Marko Id type: string outcome: enum: - created - updated - noop - restored - bound title: Outcome type: string resource: properties: name: title: Name type: string siren: anyOf: - type: string - type: 'null' default: null title: Siren forme_juridique: anyOf: - type: string - type: 'null' default: null title: Forme Juridique capital_social: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Capital Social montage: anyOf: - description: Type de montage financier du SPV. enum: - dette_senior - mezzanine - equity - mix title: MontageFinancier type: string - type: 'null' default: null date_creation: anyOf: - format: date type: string - type: 'null' default: null title: Date Creation identite_entreprise: anyOf: - description: >- Selected registry identity, bound to the company it describes. properties: siren: pattern: ^\d{9}$ title: Siren type: string siret: anyOf: - type: string - type: 'null' default: null title: Siret representant_legal: anyOf: - description: >- A single dirigeant (director/officer) of the company. properties: nom: anyOf: - type: string - type: 'null' default: null title: Nom prenom: anyOf: - type: string - type: 'null' default: null title: Prenom qualite: anyOf: - type: string - type: 'null' default: null title: Qualite date_naissance: anyOf: - type: string - type: 'null' default: null title: Date Naissance denomination: anyOf: - type: string - type: 'null' default: null title: Denomination siren: anyOf: - type: string - type: 'null' default: null title: Siren personne_morale: anyOf: - type: boolean - type: 'null' default: null title: Personne Morale qualites: items: type: string title: Qualites type: array date_prise_de_poste: anyOf: - type: string - type: 'null' default: null title: Date Prise De Poste adresse: anyOf: - properties: adresse_ligne_1: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 1 adresse_ligne_2: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 2 adresse_ligne_3: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 3 complement_adresse: anyOf: - type: string - type: 'null' default: null title: Complement Adresse code_postal: anyOf: - type: string - type: 'null' default: null title: Code Postal ville: anyOf: - type: string - type: 'null' default: null title: Ville pays: anyOf: - type: string - type: 'null' default: null title: Pays code_pays: anyOf: - type: string - type: 'null' default: null title: Code Pays latitude: anyOf: - type: number - type: 'null' default: null title: Latitude longitude: anyOf: - type: number - type: 'null' default: null title: Longitude title: SIRENAdresse type: object - type: 'null' default: null forme_juridique: anyOf: - type: string - type: 'null' default: null title: Forme Juridique title: SIRENDirigeant type: object - type: 'null' default: null presidents: anyOf: - items: description: >- A single dirigeant (director/officer) of the company. properties: nom: anyOf: - type: string - type: 'null' default: null title: Nom prenom: anyOf: - type: string - type: 'null' default: null title: Prenom qualite: anyOf: - type: string - type: 'null' default: null title: Qualite date_naissance: anyOf: - type: string - type: 'null' default: null title: Date Naissance denomination: anyOf: - type: string - type: 'null' default: null title: Denomination siren: anyOf: - type: string - type: 'null' default: null title: Siren personne_morale: anyOf: - type: boolean - type: 'null' default: null title: Personne Morale qualites: items: type: string title: Qualites type: array date_prise_de_poste: anyOf: - type: string - type: 'null' default: null title: Date Prise De Poste adresse: anyOf: - properties: adresse_ligne_1: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 1 adresse_ligne_2: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 2 adresse_ligne_3: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 3 complement_adresse: anyOf: - type: string - type: 'null' default: null title: Complement Adresse code_postal: anyOf: - type: string - type: 'null' default: null title: Code Postal ville: anyOf: - type: string - type: 'null' default: null title: Ville pays: anyOf: - type: string - type: 'null' default: null title: Pays code_pays: anyOf: - type: string - type: 'null' default: null title: Code Pays latitude: anyOf: - type: number - type: 'null' default: null title: Latitude longitude: anyOf: - type: number - type: 'null' default: null title: Longitude title: SIRENAdresse type: object - type: 'null' default: null forme_juridique: anyOf: - type: string - type: 'null' default: null title: Forme Juridique title: SIRENDirigeant type: object type: array - type: 'null' default: null title: Presidents beneficiaires_effectifs: anyOf: - items: description: >- Only the declared person's name; no private address or birth data. properties: nom: maxLength: 300 minLength: 1 title: Nom type: string prenom: anyOf: - maxLength: 300 type: string - type: 'null' default: null title: Prenom required: - nom title: SIRENBeneficiaireEffectif type: object type: array - type: 'null' default: null title: Beneficiaires Effectifs adresse_siege: anyOf: - properties: adresse_ligne_1: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 1 adresse_ligne_2: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 2 adresse_ligne_3: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 3 complement_adresse: anyOf: - type: string - type: 'null' default: null title: Complement Adresse code_postal: anyOf: - type: string - type: 'null' default: null title: Code Postal ville: anyOf: - type: string - type: 'null' default: null title: Ville pays: anyOf: - type: string - type: 'null' default: null title: Pays code_pays: anyOf: - type: string - type: 'null' default: null title: Code Pays latitude: anyOf: - type: number - type: 'null' default: null title: Latitude longitude: anyOf: - type: number - type: 'null' default: null title: Longitude title: SIRENAdresse type: object - type: 'null' default: null is_radiee: anyOf: - type: boolean - type: 'null' default: null title: Is Radiee entreprise_cessee: anyOf: - type: boolean - type: 'null' default: null title: Entreprise Cessee date_radiation: anyOf: - type: string - type: 'null' default: null title: Date Radiation date_cessation: anyOf: - type: string - type: 'null' default: null title: Date Cessation numero_tva_intracommunautaire: anyOf: - type: string - type: 'null' default: null title: Numero Tva Intracommunautaire date_cloture_exercice: anyOf: - type: string - type: 'null' default: null title: Date Cloture Exercice date_prochaine_cloture_exercice: anyOf: - type: string - type: 'null' default: null title: Date Prochaine Cloture Exercice date_cloture_exercice_exceptionnelle: anyOf: - type: string - type: 'null' default: null title: Date Cloture Exercice Exceptionnelle required: - siren title: SIRENCompanyIdentity type: object - type: 'null' default: null dirigeants: items: description: >- A single dirigeant (director/officer) of the company. properties: nom: anyOf: - type: string - type: 'null' default: null title: Nom prenom: anyOf: - type: string - type: 'null' default: null title: Prenom qualite: anyOf: - type: string - type: 'null' default: null title: Qualite date_naissance: anyOf: - type: string - type: 'null' default: null title: Date Naissance denomination: anyOf: - type: string - type: 'null' default: null title: Denomination siren: anyOf: - type: string - type: 'null' default: null title: Siren personne_morale: anyOf: - type: boolean - type: 'null' default: null title: Personne Morale qualites: items: type: string title: Qualites type: array date_prise_de_poste: anyOf: - type: string - type: 'null' default: null title: Date Prise De Poste adresse: anyOf: - properties: adresse_ligne_1: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 1 adresse_ligne_2: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 2 adresse_ligne_3: anyOf: - type: string - type: 'null' default: null title: Adresse Ligne 3 complement_adresse: anyOf: - type: string - type: 'null' default: null title: Complement Adresse code_postal: anyOf: - type: string - type: 'null' default: null title: Code Postal ville: anyOf: - type: string - type: 'null' default: null title: Ville pays: anyOf: - type: string - type: 'null' default: null title: Pays code_pays: anyOf: - type: string - type: 'null' default: null title: Code Pays latitude: anyOf: - type: number - type: 'null' default: null title: Latitude longitude: anyOf: - type: number - type: 'null' default: null title: Longitude title: SIRENAdresse type: object - type: 'null' default: null forme_juridique: anyOf: - type: string - type: 'null' default: null title: Forme Juridique title: SIRENDirigeant type: object maxItems: 500 title: Dirigeants type: array procedures_collectives: anyOf: - items: description: >- A collective proceeding reported by the company provider. properties: type: anyOf: - type: string - type: 'null' default: null title: Type date: anyOf: - type: string - type: 'null' default: null title: Date tribunal: anyOf: - type: string - type: 'null' default: null title: Tribunal title: SIRENProcedure type: object maxItems: 500 type: array - type: 'null' default: null title: Procedures Collectives organisation_pappers: anyOf: - additionalProperties: true type: object - type: 'null' default: null title: Organisation Pappers justice_pappers: anyOf: - additionalProperties: true type: object - type: 'null' default: null title: Justice Pappers id: format: uuid title: Id type: string entity_id: format: uuid title: Entity Id type: string fond_id: anyOf: - type: string format: uuid - type: 'null' default: null title: Fond Id adresse: anyOf: - type: string - type: 'null' default: null title: Adresse region: anyOf: - type: string - type: 'null' default: null title: Region beneficiaire_effectif: anyOf: - type: string - type: 'null' default: null title: Beneficiaire Effectif date_ag_annuelle: anyOf: - format: date type: string - type: 'null' default: null title: Date Ag Annuelle resultat_net_ag: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Resultat Net Ag pv_ag_document_id: anyOf: - type: string format: uuid - type: 'null' default: null title: Pv Ag Document Id procedure_collective: description: Statut de procédure collective. enum: - aucune - sauvegarde - redressement - liquidation title: ProcedureCollective type: string default: aucune litiges_en_cours: default: false title: Litiges En Cours type: boolean litiges_detail: anyOf: - type: string - type: 'null' default: null title: Litiges Detail contentieux_items: default: [] items: properties: id: anyOf: - type: string - type: 'null' default: null title: Id date_creation: anyOf: - format: date type: string - type: 'null' default: null title: Date Creation provision: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Provision montant_demande: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' default: null title: Montant Demande position: anyOf: - type: string - type: 'null' default: null title: Position partie_adverse: anyOf: - type: string - type: 'null' default: null title: Partie Adverse cabinet_avocat: anyOf: - type: string - type: 'null' default: null title: Cabinet Avocat juridiction: anyOf: - type: string - type: 'null' default: null title: Juridiction nature: anyOf: - type: string - type: 'null' default: null title: Nature detail: anyOf: - type: string - type: 'null' default: null title: Detail document_ids: items: type: string format: uuid maxItems: 20 title: Document Ids type: array title: SpvContentieuxItem type: object title: Contentieux Items type: array created_at: format: date-time title: Created At type: string updated_at: format: date-time title: Updated At type: string operations_count: anyOf: - type: integer - type: 'null' default: 0 title: Operations Count required: - name - id - entity_id - created_at - updated_at title: SPVResponse type: object taxonomy_additions: items: properties: parent_code: anyOf: - enum: - due_diligence - en_cours - en_recouvrement - termine type: string - type: 'null' default: null title: Parent Code code: title: Code type: string dimension: enum: - operation_status - investment_type - operation_type - asset_class - internal_status - operational_status - follow_up_category title: Dimension type: string display_label: title: Display Label type: string source_kind: enum: - marko - partner - entity title: Source Kind type: string source_display_name: title: Source Display Name type: string is_visible: title: Is Visible type: boolean is_active: title: Is Active type: boolean position: title: Position type: integer usage_count: default: 0 title: Usage Count type: integer label_editable: title: Label Editable type: boolean canonical_code: anyOf: - type: string - type: 'null' default: null title: Canonical Code icon_key: anyOf: - enum: - tag - briefcase - building - landmark - home - map - layers - shield - trending-up - calendar - circle-check - triangle-alert type: string - type: 'null' default: null title: Icon Key required: - code - dimension - display_label - source_kind - source_display_name - is_visible - is_active - position - label_editable title: EntityTaxonomyOptionResponse type: object title: Taxonomy Additions type: array request_id: title: Request Id type: string required: - external_id - marko_id - outcome - resource - request_id title: ExternalSPVSyncUpsertResponse type: object example: external_id: CF-SPV-001 marko_id: 33333333-3333-3333-3333-333333333333 outcome: created resource: id: 33333333-3333-3333-3333-333333333333 entity_id: 11111111-1111-1111-1111-111111111111 name: SPV Paris 19 created_at: '2026-08-22T08:00:00Z' updated_at: '2026-08-22T08:00:00Z' taxonomy_additions: [] request_id: req_cf_spv_upsert '400': description: Invalid Idempotency-Key header content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Bad Request status: 400 detail: >- Idempotency-Key must contain at most 255 visible ASCII characters without spaces. request_id: req_example_partner_call '401': description: Authentication required content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Unauthorized status: 401 detail: A valid bearer token is required. request_id: req_example_partner_call '403': description: Scope, route or IP restriction content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Forbidden status: 403 detail: The API key does not allow this operation. request_id: req_example_partner_call '409': description: Idempotency or write target conflict content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Conflict status: 409 detail: >- The idempotency key payload, external reference, target, or source conflicts with an existing write. request_id: req_example_partner_call '422': description: Validation failed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Unprocessable Content status: 422 detail: The request payload or parameters are invalid. request_id: req_example_partner_call '428': description: Required Idempotency-Key header is missing content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Precondition Required status: 428 detail: The Idempotency-Key header is required. request_id: req_example_partner_call '429': description: Rate limit or progressive ban headers: Retry-After: description: Cooldown in seconds before retrying the request. schema: type: string content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Too Many Requests status: 429 detail: The request rate limit was exceeded. request_id: req_example_partner_call '500': description: Unexpected server error content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Internal Server Error status: 500 detail: An unexpected server error occurred. request_id: req_example_partner_call deprecated: false security: - BearerAuth: [] components: schemas: ProblemDetails: type: object required: - title - status - detail properties: type: type: string default: about:blank title: type: string status: type: integer detail: type: string request_id: type: string scope: type: string route_id: type: string reason_code: type: string securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: MARKO short-lived bearer description: >- Use the `access_token` returned by `POST /v1/auth/token`. Do not send the raw API secret on business endpoints. ````