API Documentation

Public REST API for InvestorMatch.Pro. The /api/v1 endpoints upload a pitch deck for AI analysis, report job status and return ranked investor matches; they take a Bearer API key (im_live_… for production, im_test_… for test mode, which never charges). The deck/campaign endpoints are credit-metered and rate-limited; the blog endpoint is a separate, admin-only, free, unmetered publishing channel. The "Agent:" tags document the web app's own routes that an API key or OAuth token reaches by scope (read, campaigns:write, teardowns:write, outreach:send, billing), and the guest path: create a campaign without an account and keep its campaign_token. Test keys do not skip charges there.

Base URL: https://investormatch.pro/api/v1. A machine-readable OpenAPI 3 description is served at /openapi.json.

Quick start

  1. Get your API key — generate a test or live key from your account settings.
  2. Submit a pitch deck — upload a PDF or provide a URL to analyze.
  3. Get investor matches — retrieve AI-powered investor recommendations with fit scores.

Authentication

Every request carries a Bearer API key in the Authorization header. Keys prefixed im_live_ run against production and consume credits; keys prefixed im_test_ run in test mode so you can develop safely before going live.

Rate limits

  • Free tier: 5 API calls per month.
  • Paid tier: 60 requests per minute and 1,000 requests per day.

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoints

Admin

Admin-only read endpoints for the site's own dashboards. Require an API key owned by an admin; any other valid key receives 403. Free and unmetered.

  • GET /api/v1/admin/crawler-hits — AI-crawler hit counts (admin-only)

Analysis

Paid deck-analysis endpoints. Usable by any valid API key. Credit-metered and rate-limited (60 req/min, 1,000 req/day on paid tier).

  • POST /api/v1/analyze — Submit a pitch deck for analysis
  • GET /api/v1/jobs/{id} — Get job status
  • GET /api/v1/jobs/{id}/matches — Get ranked investor matches

Blog

Admin-only blog publishing. Requires an API key owned by an admin; any other valid key receives 403. Free, unmetered, and not rate-limited. The only programmatic blog action is creating a draft — listing, editing, and publishing happen in the admin dashboard, not via the API.

  • POST /api/v1/blog/posts — Create a blog post draft (admin-only)

Credits

Check your credit balance and free-quota usage, list purchasable bundles, and start a Stripe checkout to top up. Authenticated and rate-limited; these calls do not themselves consume analysis credits.

  • GET /api/v1/credits — Get credit balance and usage
  • GET /api/v1/credits/bundles — List purchasable credit bundles
  • POST /api/v1/credits/purchase — Start a credit purchase (Stripe Checkout)
  • POST /api/v1/credits/webhook — Stripe payment webhook (internal)

API Keys

Programmatically create, list, and revoke your own API keys. Authenticated with an existing key and rate-limited; these calls do not consume analysis credits.

  • POST /api/v1/keys — Create a new API key
  • GET /api/v1/keys — List your API keys
  • DELETE /api/v1/keys/{id} — Revoke an API key

Auto-Refill

Read and update your automatic credit top-up settings (threshold, amount, monthly cap, and saved payment method). Authenticated and rate-limited.

  • GET /api/v1/auto-refill — Get auto-refill settings
  • PUT /api/v1/auto-refill — Update auto-refill settings

Investors

Read-only access to the verified investor database — search firms and fetch a firm's partners and portfolio. Authenticated and rate-limited; does not consume analysis credits.

  • GET /api/v1/investors — Search the verified investor database
  • GET /api/v1/investors/{id} — Get a single investor firm
  • GET /api/v1/investors/{id}/partners — Get a firm's partners
  • GET /api/v1/investors/{id}/portfolio — Get a firm's portfolio

Agent: Campaigns

The web app's campaign routes, callable with a scoped API key or OAuth token (Bearer) or, for a campaign the agent created as a guest, its `campaign_token` in `X-Campaign-Token`. Deck upload, campaign creation, status, context confirmation, matches and deletion.

  • POST /api/uploads/request-url — Get a presigned URL to upload a deck
  • POST /api/campaigns — Create a campaign from an uploaded deck
  • POST /api/campaigns/from-link — Create a campaign from a deck link
  • DELETE /api/campaigns/{id} — Delete a campaign
  • GET /api/campaigns/{id}/status — Campaign processing status
  • POST /api/campaigns/{id}/confirm-context — Confirm the extracted company profile and start matching
  • GET /api/campaigns/{id}/scorecard — Campaign matches (the scorecard)

Agent: Teardowns

Deck teardowns on a campaign: free preview, status, purchase, results and the PDF.

  • POST /api/campaigns/{id}/teardown/request-free — Start the free teardown preview
  • GET /api/campaigns/{id}/teardown/status — Teardown status
  • POST /api/campaigns/{id}/teardown/checkout — Buy the full teardown
  • GET /api/campaigns/{id}/teardown/results — Teardown report
  • GET /api/campaigns/{id}/teardown/pdf — Teardown report PDF

Agent: Payments

Unlock a campaign. These either complete for free (credit, discount, sponsorship) or return a Stripe Checkout `url` that a human must open and pay. Scope `billing`.

  • POST /api/campaigns/{id}/checkout — Unlock a campaign (Stripe Checkout)
  • POST /api/campaigns/{id}/use-referral-credit — Unlock a campaign with a credit

Agent: Files

Exports of an unlocked campaign and the deck itself, as file downloads.

  • POST /api/campaigns/{id}/fit-report/generate — Publish the Fit Report
  • GET /api/campaigns/{id}/export-csv — Matches as CSV
  • GET /api/campaigns/{id}/export-pdf — Investor scorecard PDF
  • GET /api/campaigns/{id}/export-warm-referrals — Warm referrals PDF
  • GET /api/campaigns/{id}/export-all — All exports as a ZIP
  • GET /api/campaigns/{id}/deck — The campaign's deck file

Agent: Outreach

The outreach drafts written for a campaign's matches.

  • GET /api/campaigns/{id}/outreach — Outreach drafts for a campaign's matches
  • PATCH /api/outreach/{id} — Edit one outreach draft

Agent: Account

The founder's campaigns, account messages, API keys and webhooks. Webhook deliveries are JSON POSTs signed with `X-InvestorMatch-Signature: t=<unix seconds>,v1=<hex>`, v1 being the HMAC-SHA256 of `<t>.<raw body>` keyed with the webhook's secret.

  • GET /api/my-campaigns — List the owner's campaigns
  • GET /api/user/messages — Unread account messages
  • GET /api/account/webhooks — List webhooks
  • POST /api/account/webhooks — Create a webhook
  • DELETE /api/account/webhooks/{id} — Delete a webhook
  • GET /api/account/api-keys — List API keys

MCP server (AI assistants)

InvestorMatch runs a remote MCP (Model Context Protocol) server, so AI assistants such as Claude and ChatGPT can search the investor directory and read your campaigns, matches, outreach drafts and teardowns. Read tools change nothing. Write tools act only on your own account and need an API key or OAuth grant with the matching scope. Tools that spend money or send email do nothing until called with confirm: true; without it they return a quote or refuse.

Endpoints

  • POST https://investormatch.pro/mcp — signed in (OAuth or API key); all 32 tools.
  • POST https://investormatch.pro/mcp/public — anonymous, no sign-in; the 4 public directory tools only.

Authentication

AI assistants: add https://investormatch.pro/mcp as a custom connector and sign in with your InvestorMatch account when prompted (OAuth). Manage or revoke connected assistants from your account settings.

Developers: send an API key as Authorization: Bearer im_live_…. A request to /mcp without a valid token gets 401 with a WWW-Authenticate header pointing at the OAuth metadata.

Public tools (both endpoints)

  • search_investors — Search the public VC directory by firm name, stage, sector and HQ location.
  • get_investor — Get a firm's full public profile: thesis, check size, partners, portfolio and funds.
  • list_investor_filters — List the stage, sector and location values search_investors accepts.
  • search_fundraising_guides — Search InvestorMatch's published fundraising guides and articles.

Founder tools (signed in, /mcp only)

  • list_my_campaigns — List your fundraising campaigns with status, unlock state and match count.
  • get_campaign — Get one campaign: status and the company profile extracted from your deck.
  • list_matches — List a campaign's matched investors, best fit first, with fit score and reasons.
  • get_match — Get the full detail of one match: why the firm fits and the partner to pitch.
  • get_outreach_drafts — Get the pre-drafted cold emails and LinkedIn messages for a campaign's matches.
  • list_my_teardowns — List your pitch-deck teardowns with status and readiness score.
  • get_teardown — Get a teardown report: readiness score, critical issues and action plan.
  • create_upload_url — Get a URL to upload a pitch deck file (step 1 of creating a campaign).
  • create_campaign — Create a matching or teardown campaign from an uploaded deck or a deck link.
  • get_campaign_status — Check a campaign's processing progress and the next step.
  • confirm_context — Confirm or correct the profile extracted from the deck and start matching.
  • edit_campaign — Change a campaign's stage, raise or focus and re-run matching (re-locks it).
  • retry_campaign — Retry a campaign whose processing failed.
  • clone_for_more_matches — Start a new campaign from the same deck that skips firms already shown.
  • reveal_more_matches — Reveal more already-scored matches on an unlocked campaign.
  • delete_campaign — Delete a campaign from your account (asks for confirmation).
  • create_share_link — Get a view-only link to a campaign's matches to share.
  • list_messages — List your unread account messages, such as processing failure notices.
  • request_teardown_preview — Start a campaign's free deck teardown preview.
  • get_teardown_status — Check a teardown: purchased, run status and stage, re-runs left, what to do next.
  • purchase_teardown — Quote the full teardown, or with confirm buy it (free when covered, else a Stripe link).
  • rerun_teardown — Re-run a purchased teardown with a different stage, raise amount or sector.
  • unlock_campaign — Quote a campaign unlock, or with confirm pay with a credit or a Stripe link.
  • get_files — Get 24-hour read-only download links for the deck, exports and teardown PDFs.
  • create_fit_report_link — With confirm, publish the campaign's Fit Report at a public link.
  • update_outreach_draft — Edit one match's outreach draft: email variants, LinkedIn messages, notes.
  • send_one_click_pitch — With confirm, email your deck to a matched firm's deal-submission inbox.
  • send_warm_intros — With confirm, email up to 20 of your contacts asking for warm intros.

MCP rate limits

  • Anonymous: 30 requests per minute and 500 per day, per IP.
  • Signed in: 120 requests per minute.

Examples

Add it to Claude Code:

claude mcp add --transport http investormatch https://investormatch.pro/mcp

Initialize a session against the public endpoint:

curl -X POST https://investormatch.pro/mcp/public \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Manage your API keys | How Investor Match works | Pricing