---
title: "Get ranked investor matches"
method: GET
path: "/api/v1/jobs/{id}/matches"
tags: ["Analysis"]
---

# Get ranked investor matches

`GET /api/v1/jobs/{id}/matches`

## Request

- Base URL: `https://investormatch.pro`
- URL: `https://investormatch.pro/api/v1/jobs/{id}/matches`
- Auth: HTTP bearer

Returns up to 20 ranked investor matches for a completed job. The first access charges one credit (unless test mode or free quota). Use ?format=csv, ?format=scorecard-pdf, ?format=emails-pdf, or ?format=warm-referrals-pdf for alternative export formats; the default is JSON.

## Path parameters

- `id` string, required

## Query parameters

- `format` 'json' | 'csv' | 'scorecard-pdf' | 'emails-pdf' | 'warm-referrals-pdf'

## Response `200`

Ranked matches (JSON) or a file download for non-JSON formats.

- MatchesResponse
  - `matches` Match[]
    - `rank` integer
    - `firm_name` string
    - `fit_score` number
    - `fit_reasoning` string
    - `check_size_min` number, nullable
    - `check_size_max` number, nullable
    - `stages` string[]
    - `sectors` string[]
    - `website` string, nullable
    - `partners` MatchPartner[]
      - `name` string
      - `email` string, nullable
      - `linkedin_url` string, nullable
      - `role` string, nullable

## Other responses

- `400`: Job is not completed yet.
- `401`: Missing or invalid API key.
- `402`: Insufficient credits to access matches.
- `404`: Job not found (or not owned by this key).

---

[API](https://skmtc.dev/investormatch/apis/investormatch-pro-api.md) · [All operations](https://skmtc.dev/investormatch/apis/investormatch-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/investormatch/apis/investormatch-pro-api/revisions/647f22300043?raw)