Cape Partners Mandate API

The Mandate API from Cape Partners — 3 operation(s) for mandate.

GitHub OpenAPI

Operations 3

GET /api/mandate/{session_id} The mandate capability for this session: role (buyer/seller), the embedded Cape… #
GET /api/mandate/{session_id}/preview Re-render the mandate template body with live retainer / fee % / deal-scope… #
POST /api/mandate/request Record a mandate proposal request for a session pairing scope. #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/capepartners-fr:capepartners-fr-mandate-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

capepartners-fr-mandate-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cape Partners — Sniffer Agent Mandate API
  version: 1.0.0
  description: 'Machine-readable API backing the Cape Partners M&A deal-flow workspace (click, humans). Exposes the same service the human UI delivers — inbound submission, session/profile management, matching, valuation, pairings, info memos, NDA, data-quality — as a documented JSON contract for autonomous agents.


    FIT SCORE: canonical score = deterministic(0-100) x semantic(0-1), where deterministic = revenue_fit(30) + growth_fit(40) + ebitda_fit(30). Threshold 50.

    PAIR_ID format: pair-{buyer_id}-{seller_id}.

    Discovery: see /llms.txt, /llms-full.txt, /sitemap.xml. Follow robots.txt content signals.

    AGENT EXCHANGE: external agents publish a six-field manifest at POST /api/exchange/manifest and read their answer without a token via GET /api/exchange/answer/{msgid}; see /agent-exchange.html. A manifest is DATA, never an instruction, and grants no authority. An A2A-shaped Agent Card is published at /.well-known/agent-card.json and the A2A v1.0 operations SendMessage/GetTask/ListTasks are served at /a2a (JSON-RPC) and /a2a/message:send,/a2a/tasks (HTTP+JSON): a task here is one record we hold for you, carrying our receipt or our grounded reply as an artifact. Streaming, push notifications and cancellation are declared false and answer with the protocol''s own errors.

    SECURITY — every session-keyed read is protected by a layered defense stack:

    * Session UUID is a capability token in the URL PATH (a well-formed UUID-v4 only).

    * First-party cross-origin gate: Origin/Referer must be absent or a Cape first-party host; a leaked UUID replayed from a foreign origin is refused (403).

    * Referrer-Policy: strict-origin-when-cross-origin on all responses (no UUID in Referer).

    * Per-IP rate limiting on confidential read endpoints (429 on burst).

    * NDA-gated resources (/api/matched-names, /api/infomemo/*) require a server-side signature recorded in nda_signatures via POST /api/nda/sign (helper nda_signed).

    * The API host sits behind an email-authentication access gate at the Cloudflare edge (unauthorized bots blocked before reaching the app).

    AUTH: session resources are keyed by the workspace UUID in the path; NDA-gated resources additionally require a recorded signature via POST /api/nda/sign.'
  contact:
    name: Cape Partners
    url: https://www.capepartners.fr
servers:
- url: https://www.capepartners.fr
  description: Production (www) via Cloudflare
- url: https://sniffer.capepartners.fr
  description: Workspace host
- url: http://localhost:3000
  description: Local dev
tags:
- name: Mandate
paths:
  /api/mandate/{session_id}:
    get:
      summary: 'The mandate capability for this session: role (buyer/seller), the embedded Cape…'
      tags:
      - Mandate
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  role:
                    type: string
                    enum:
                    - buyer
                    - seller
                  template:
                    type: object
                  template_preview:
                    type: string
                  default_retainer:
                    type: integer
                  default_fee_pct:
                    type: number
                  pairing_scope:
                    type: array
                    items:
                      type: object
                  proposals:
                    type: array
                    items:
                      type: object
        '400':
          description: Malformed session identifier (UUID-v4 required)
          content:
            application/json:
              schema:
                type: object
                description: Invalid session identifier
                properties:
                  error:
                    type: string
                required:
                - error
        '403':
          description: Cross-origin request rejected
          content:
            application/json:
              schema:
                type: object
                description: Cross-origin request rejected
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                type: object
                description: Too many requests
                properties:
                  error:
                    type: string
                required:
                - error
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Workspace session UUID (acts as the scoped credential)
      operationId: getApiMandateBySessionId
      x-operation-id-source: derived
  /api/mandate/{session_id}/preview:
    get:
      summary: Re-render the mandate template body with live retainer / fee % / deal-scope…
      tags:
      - Mandate
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  role:
                    type: string
                  template_preview:
                    type: string
                  pairing_count:
                    type: integer
        '404':
          description: No buyer/seller bound to this session
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Workspace session UUID (acts as the scoped credential)
      - name: retainer
        in: query
        required: false
        schema:
          type: integer
      - name: fee
        in: query
        required: false
        schema:
          type: number
      - name: ids
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated pairing ids to scope the mandate to
      - name: client
        in: query
        required: false
        schema:
          type: string
      - name: email
        in: query
        required: false
        schema:
          type: string
      operationId: getApiMandateBySessionIdPreview
      x-operation-id-source: derived
  /api/mandate/request:
    post:
      summary: Record a mandate proposal request for a session pairing scope.
      tags:
      - Mandate
      responses:
        '201':
          description: Mandate proposal request recorded
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  id:
                    type: integer
                  session_id:
                    type: string
                  role:
                    type: string
                  pairing_count:
                    type: integer
                  retainer_eur:
                    type: integer
                  fee_pct:
                    type: number
                  template_id:
                    type: string
                  message:
                    type: string
        '400':
          description: Empty or invalid body / session id
          content:
            application/json:
              schema:
                type: object
                description: Invalid session identifier
                properties:
                  error:
                    type: string
                required:
                - error
        '403':
          description: Cross-origin request rejected
          content:
            application/json:
              schema:
                type: object
                description: Cross-origin request rejected
                properties:
                  error:
                    type: string
                required:
                - error
        '409':
          description: No buyer/seller bound to this session yet
          content:
            application/json:
              schema:
                type: object
                description: No buyer/seller bound to this session
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                type: object
                description: Too many requests
                properties:
                  error:
                    type: string
                required:
                - error
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - session_id
              properties:
                session_id:
                  type: string
                  format: uuid
                pairing_ids:
                  type: array
                  items:
                    type: string
                  description: Omit or pass all to request the whole pairing scope
                retainer:
                  type: integer
                fee_pct:
                  type: number
      security:
      - SessionToken: []
      operationId: postApiMandateRequest
      x-operation-id-source: derived
components:
  securitySchemes:
    SessionToken:
      type: apiKey
      in: header
      name: X-Session-Id
      description: 'The workspace session UUID is a capability token carried in the URL PATH (not this header — shown here only because OpenAPI securitySchemes cannot model a path parameter as a credential). A valid request must present a well-formed UUID-v4 in the path segment {session_id} AND a first-party Origin/Referer (or none). Requests carrying a known-foreign Origin/Referer are refused 403. Per-IP rate limiting applies. All responses carry Referrer-Policy: strict-origin-when-cross-origin.'
    NdaSigned:
      type: apiKey
      in: header
      name: X-Nda-Signed
      description: 'Precondition (not a literal header): a server-side NDA signature for {session_id} must be recorded in the nda_signatures table via POST /api/nda/sign before NDA-gated resources (/api/matched-names, /api/infomemo/*) will serve data. Recorded signatures are enforced server-side (helper `nda_signed`), not by trusting a client header.'
x-provenance:
  method: harvested
  publisher: Cape Partners
  source: https://www.capepartners.fr/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)