---
title: "Match a contact email to deals & leads"
method: GET
path: "/v1/match"
tags: ["Match"]
---

# Match a contact email to deals & leads

`GET /v1/match`

## Request

- Base URL: `https://app.getdealboard.com`
- URL: `https://app.getdealboard.com/v1/match`
- Auth: HTTP bearer

Finds deals and leads whose primary-contact / work email matches the address (exact, case-insensitive), with a domain fallback when nothing exact hits. Powers the Gmail extension sidebar. Each result `url` is the shareable /deals/<id> · /leads/<id> deep-link.

## Query parameters

- `email` string, email, required

## Response `200`

OK

- object
  - `email` string, required
  - `domain` string, nullable
  - `match` 'email' | 'domain' | 'none', required
  - `deals` object[], required
    - `id` string, uuid
    - `name` string
    - `company` string, nullable
    - `stage` string, nullable
    - `amount_cents` integer, nullable
    - `url` string
  - `leads` object[], required
    - `id` string, uuid
    - `name` string, nullable
    - `company` string, nullable
    - `status` string
    - `url` string

## Other responses

- `400`: `email` is required.
- `401`: Missing or invalid credential.

---

[API](https://skmtc.dev/getdealboard/apis/dealboard-api.md) · [All operations](https://skmtc.dev/getdealboard/apis/dealboard-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getdealboard/apis/dealboard-api/revisions/4066bf9d265e?raw)