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.
openapi: 3.2.0
info:
title: Cape Partners — Sniffer Agent Search 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: Search
paths:
/api/search/{session_id}:
get:
summary: Manual search of sellers and buyers by name/sector/product.
tags:
- Search
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
parameters:
- name: session_id
in: path
required: true
schema:
type: string
format: uuid
description: Workspace session UUID
- name: q
in: query
required: true
schema:
type: string
description: Search term
operationId: getApiSearchBySessionId
x-operation-id-source: derived
components:
schemas:
SearchSeller:
type: object
properties:
id:
type: integer
name:
type: string
sector:
type: string
revenue:
type: number
ebitda:
type: number
product:
type: string
contact_name:
type: string
contact_email:
type: string
paired:
type: boolean
description: Pairing already exists relative to this requesting session
SearchBuyer:
type: object
properties:
id:
type: integer
name:
type: string
sector:
type: string
ticket_min:
type: number
ticket_max:
type: number
contact:
type: string
contact_email:
type: string
paired:
type: boolean
SearchResponse:
type: object
properties:
sellers:
type: array
items:
$ref: '#/components/schemas/SearchSeller'
buyers:
type: array
items:
$ref: '#/components/schemas/SearchBuyer'
total:
type: integer
query:
type: string
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)