Récupérer une opération par identifiant externe

Résout l’identifiant stable du système partenaire et retourne immédiatement l’identifiant MARKO et la ressource courante. Les codes custom__... sont générés par MARKO : conservez toujours le code renvoyé au lieu de le construire.

Scope requis : operations:read. Scopes et délégation.

Récupérer une opération par identifiant externe

cURL

curl --request GET \
  --url https://partner-api.marko.fr/v1/operations/external/{external_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "44444444-4444-4444-4444-444444444444",
  "spv_id": "33333333-3333-3333-3333-333333333333",
  "name": "ClubFunding Demo Deal",
  "status": "custom__a3e08c7bde__projet_emis",
  "data": {},
  "created_at": "2026-08-22T08:00:00Z",
  "updated_at": "2026-08-22T08:00:00Z"
}

Authorizations

Authorization · string · header · required

Use the access_token returned by POST /v1/auth/token. Do not send the raw API secret on business endpoints.

Headers

X-Request-ID · string

Partner-generated correlation identifier echoed in logs and error payloads.

Path Parameters

external_id · string · required

Identifiant stable de votre système, dans le contexte de votre intégration.

Required string length: 1 - 255

Pattern: ^[A-Za-z0-9_~-][A-Za-z0-9._:~-]{0,254}$

Response

200

application/json

Successful response

id · string<uuid> · required

Identifiant MARKO de la ressource.

name · string · required

Nom de la ressource. Les recherches exactes et partielles sont décrites au niveau de la route.

status · string · required

Statut métier de l'opération. Pour une écriture externe, consulter la dimension operation_status de GET /taxonomies.

created_at · string<date-time> · required

Date de création au format ISO 8601.

updated_at · string<date-time> · required

Date de dernière modification au format ISO 8601.

spv_id · string<uuid> | null

UUID MARKO de la SPV.

lead_operateur_id · string<uuid> | null

UUID MARKO de l'opérateur principal de l'opération.

type_investissement · string | null

Code de type d'investissement; consulter la dimension investment_type de GET /taxonomies.

type_operation · string | null

Code de type d'opération; consulter la dimension operation_type de GET /taxonomies.

classe_actif · string | null

Classe d'actif de l'opération. Pour une écriture externe, consulter la dimension asset_class de GET /taxonomies.

statut_interne · string | null

Code de statut interne de l'opération; consulter la dimension internal_status de GET /taxonomies.

statut_operationnel · string[] | null

Codes de statuts opérationnels de l'opération; consulter la dimension operational_status de GET /taxonomies.

sous_classe_actif · string | null

Sous-classe d'actif de l'opération.

data · Data · object

Données métier de l'opération. Consultez GET /field-definitions pour les clés, types et unités disponibles; ne déduisez pas les unités des noms.

kpi_snapshot · Kpi Snapshot · object | null

Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint.