Lister les SPV

Permet de rechercher un SPV par nom exact insensible a la casse via name, et de filtrer par fonds via fond_id. Le filtre par nom est un controle avant creation, pas une garantie d’unicite concurrente; conservez l’identifiant MARKO et utilisez Idempotency-Key pour les ecritures. Les en-tetes X-Marko-Limit, X-Marko-Offset et X-Marko-Has-More decrivent la page.

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

Lister les SPV

cURL

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

200

[
  {
    "id": "33333333-3333-3333-3333-333333333333",
    "fond_id": "22222222-2222-2222-2222-222222222222",
    "name": "SPV Paris 19",
    "siren": "987654321",
    "forme_juridique": "SAS",
    "montage": "direct",
    "procedure_collective": "aucune",
    "is_draft": false,
    "created_at": "2026-02-01T09:15:00Z",
    "updated_at": "2026-03-20T10: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.

Query Parameters

name · string

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

Maximum string length: 255

fond_id · string<uuid> | null

UUID MARKO du fonds.

limit · integer · default: 50

Nombre maximal de résultats sur cette page; bornes et valeur par défaut ci-dessous.

Required range: 1 <= x <= 200

offset · integer · default: 0

Nombre de résultats à ignorer avant cette page (commence à 0).

Required range: x >= 0

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.

procedure_collective · string · required

Indique si une procédure collective est déclarée pour la SPV.

is_draft · boolean · required

Indique si la SPV est encore à l'état de brouillon.

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.

fond_id · string<uuid> | null

UUID MARKO du fonds.

siren · string | null

SIREN français sur 9 chiffres; le service vérifie aussi le checksum lorsque la route le prévoit.

forme_juridique · string | null

Forme juridique déclarée de la société.

montage · string | null

Montage financier de la SPV; utiliser une valeur de l'énumération.