Lister les recommandations d'automatisation

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

const url = 'https://partner-api.marko.fr/v1/workflows/recommendations';
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/workflows/recommendations', 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/workflows/recommendations",
  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;
}

{
  "scope_type": "entity",
  "scope_id": null,
  "scope_label": "Entity",
  "generated_at": "2026-10-01T10:00:00Z",
  "items": [],
  "bundles": [],
  "kpis": {
    "recommendations_total": 0,
    "recommendation_acceptance_rate": 0,
    "recommendation_dismiss_rate": 0,
    "recommendation_snooze_rate": 0,
    "time_to_activation_after_recommendation_hours": null,
    "prefill_edit_rate": 0,
    "workflow_disabled_soon_after_activation_rate": 0,
    "workflow_utility_score": 0,
    "monthly_false_positive_count": 0,
    "monthly_false_negative_proxy_count": 0
  }
}

{
  "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

scope_type

enum<string>

default:entity

Périmètre auquel la recommandation ou l'objet se rapporte.

Available options:

entity,

fund,

spv,

operation

only_high_priority

boolean

default:false

Limiter aux recommandations de priorité élevée.

include_dismissed

boolean

default:false

Inclure les recommandations classées comme non pertinentes.

scope_id

string<uuid> | null

Paramètre scope_id de cette route; contraintes ci-dessous.

Response

Successful response

scope_type

string

required

Périmètre auquel la recommandation ou l'objet se rapporte.

scope_id

string<uuid> | null

required

Identifiant de la ressource du périmètre; il peut être absent pour le périmètre entité.

scope_label

string

required

Nom lisible du périmètre des recommandations.

generated_at

string<date-time>

required

Date de génération des recommandations.

items

object[]

required

Résultats de la page courante.

Show child attributes

bundles

object[]

required

Recommandations regroupées par thème et accompagnées de leurs compteurs.

Show child attributes

kpis

object

required

Indicateurs de suivi des recommandations, distincts des KPI financiers d'une opération.

Show child attributes

Lister les recommandations d'automatisation

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

const url = 'https://partner-api.marko.fr/v1/workflows/recommendations';
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/workflows/recommendations', 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/workflows/recommendations",
  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;
}

{
  "scope_type": "entity",
  "scope_id": null,
  "scope_label": "Entity",
  "generated_at": "2026-10-01T10:00:00Z",
  "items": [],
  "bundles": [],
  "kpis": {
    "recommendations_total": 0,
    "recommendation_acceptance_rate": 0,
    "recommendation_dismiss_rate": 0,
    "recommendation_snooze_rate": 0,
    "time_to_activation_after_recommendation_hours": null,
    "prefill_edit_rate": 0,
    "workflow_disabled_soon_after_activation_rate": 0,
    "workflow_utility_score": 0,
    "monthly_false_positive_count": 0,
    "monthly_false_negative_proxy_count": 0
  }
}

{
  "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 recommandations d'automatisation

Authorizations

Headers

Query Parameters

Response