Lister les operations

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

const url = 'https://partner-api.marko.fr/v1/operations';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://partner-api.marko.fr/v1/operations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partner-api.marko.fr/v1/operations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

[
  {
    "id": "44444444-4444-4444-4444-444444444444",
    "spv_id": "33333333-3333-3333-3333-333333333333",
    "relationship_status": "attached",
    "relationship_label": "Rattachée",
    "name": "Clubfunding Demo Deal",
    "status": "instruction",
    "phase": "p03_financement",
    "type_investissement": "dette_senior",
    "type_operation": "acquisition_detention",
    "classe_actif": "residentiel",
    "statut_interne": "analyse",
    "statut_operationnel": [
      "commercialisation"
    ],
    "sous_classe_actif": "residentiel_coliving",
    "version": 3,
    "created_at": "2026-03-10T08:00:00Z",
    "updated_at": "2026-03-21T14:30:00Z",
    "financial_summary": {
      "montant_nominal_contractuel": 2500000,
      "montant_total": 2500000
    },
    "reporting_summary": {
      "mode_reporting": "trimestriel",
      "frequence_reporting": 3,
      "reporting_status": "pending",
      "taux_completude_reporting": 68.5
    }
  }
]

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}

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.

Query Parameters

name

string

Nom exact, insensible a la casse et aux espaces peripheriques. Exact operation name, case-insensitive and trimmed

Maximum string length: 255

limit

integer

default:50

Nombre maximal d'operations retournees.

Required range: 1 <= x <= 200

offset

integer

default:0

Nombre d'operations a ignorer avant la page retournee.

Required range: x >= 0

status

string

Filter by the exact entity taxonomy code. active expands to the five active canonical MARKO statuses. Filter by operation lifecycle status. Use active to match sourcing, instruction, travaux, commercialisation and livraison.

Maximum string length: 180

spv_id

string<uuid>

Identifiant MARKO exact du SPV rattache.

Response

Successful response

string<uuid>

required

Identifiant MARKO de la ressource.

relationship_status

enum<string>

required

État du rattachement de l'opération visible dans ce contexte.

Available options:

attached,

pending_attachment

relationship_label

string

required

Libellé du rattachement de l'opération visible dans ce contexte.

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.

phase

string

required

Phase métier de l'opération; distincte de son statut.

version

integer

required

Version de la ressource MARKO.

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.

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.

financial_summary

Financial Summary · object

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

reporting_summary

Reporting Summary · object

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

⌘I

Lister les operations

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

const url = 'https://partner-api.marko.fr/v1/operations';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://partner-api.marko.fr/v1/operations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partner-api.marko.fr/v1/operations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

[
  {
    "id": "44444444-4444-4444-4444-444444444444",
    "spv_id": "33333333-3333-3333-3333-333333333333",
    "relationship_status": "attached",
    "relationship_label": "Rattachée",
    "name": "Clubfunding Demo Deal",
    "status": "instruction",
    "phase": "p03_financement",
    "type_investissement": "dette_senior",
    "type_operation": "acquisition_detention",
    "classe_actif": "residentiel",
    "statut_interne": "analyse",
    "statut_operationnel": [
      "commercialisation"
    ],
    "sous_classe_actif": "residentiel_coliving",
    "version": 3,
    "created_at": "2026-03-10T08:00:00Z",
    "updated_at": "2026-03-21T14:30:00Z",
    "financial_summary": {
      "montant_nominal_contractuel": 2500000,
      "montant_total": 2500000
    },
    "reporting_summary": {
      "mode_reporting": "trimestriel",
      "frequence_reporting": 3,
      "reporting_status": "pending",
      "taux_completude_reporting": 68.5
    }
  }
]

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}

Démarrer

Tutoriels

Intégrer

Référence API

Lister les operations

Authorizations

Headers

Query Parameters

Response