> ## 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. # Lister les operations > Supporte la recherche par nom exact insensible a la casse, la pagination, le filtrage par statut et le filtrage par SPV. Le filtre par nom est un controle avant creation, pas une garantie d'unicite concurrente; conservez l'identifiant MARKO et utilisez external_id avec Idempotency-Key. ## OpenAPI ````yaml https://partner-api.marko.fr/v1/openapi.json get /operations 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: /operations: get: tags: - operations summary: Lister les operations description: >- Supporte la recherche par nom exact insensible a la casse, la pagination, le filtrage par statut et le filtrage par SPV. Le filtre par nom est un controle avant creation, pas une garantie d'unicite concurrente; conservez l'identifiant MARKO et utilisez external_id avec Idempotency-Key. operationId: operations_list parameters: - in: query name: name required: false schema: type: string maxLength: 255 description: Nom exact, insensible a la casse et aux espaces peripheriques. example: Clubfunding Demo Deal - in: query name: limit required: false schema: type: integer minimum: 1 maximum: 200 description: Nombre maximal d'operations retournees. example: 20 - in: query name: offset required: false schema: type: integer minimum: 0 description: Nombre d'operations a ignorer avant la page retournee. example: 0 - in: query name: status required: false schema: type: string maxLength: 180 description: >- Filter by the exact entity taxonomy code. `active` expands to the five active canonical MARKO statuses. example: active - in: query name: spv_id required: false schema: type: string format: uuid description: Identifiant MARKO exact du SPV rattache. example: 33333333-3333-3333-3333-333333333333 - in: header name: X-Request-ID required: false description: >- Partner-generated correlation identifier echoed in logs and error payloads. schema: type: string example: marko-operations-list responses: '200': description: Successful response content: application/json: schema: items: properties: id: format: uuid title: Id type: string spv_id: anyOf: - type: string format: uuid - type: 'null' default: null title: Spv Id relationship_status: enum: - attached - pending_attachment title: Relationship Status type: string relationship_label: title: Relationship Label type: string name: title: Name type: string status: title: Status type: string phase: title: Phase type: string type_investissement: anyOf: - type: string - type: 'null' default: null title: Type Investissement type_operation: anyOf: - type: string - type: 'null' default: null title: Type Operation classe_actif: anyOf: - type: string - type: 'null' default: null title: Classe Actif statut_interne: anyOf: - type: string - type: 'null' default: null title: Statut Interne statut_operationnel: anyOf: - items: type: string type: array - type: 'null' default: null title: Statut Operationnel sous_classe_actif: anyOf: - type: string - type: 'null' default: null title: Sous Classe Actif version: title: Version type: integer created_at: format: date-time title: Created At type: string updated_at: format: date-time title: Updated At type: string financial_summary: additionalProperties: true title: Financial Summary type: object reporting_summary: additionalProperties: true title: Reporting Summary type: object required: - id - relationship_status - relationship_label - name - status - phase - version - created_at - updated_at title: PublicOperationItem type: object type: array example: - 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 '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 '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 '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. ````