---
title: "Qualify Contact"
method: POST
path: "/v1/contacts/qualify"
tags: ["contacts"]
---

# Qualify Contact

`POST /v1/contacts/qualify`

Check whether a contact matches your ideal customer profile.

Pass a `contact_id` to qualify a stored contact, or describe the person
inline to qualify one you have not imported yet. The workspace's own ICP is
used unless `icp_context` overrides it.

Requires the `contacts:read` scope on the API key.

## Request body

- QualifyContactPublicInput
  - `contact_id` string, uuid, nullable — Contact to qualify. Its stored details fill in the fields below.
  - `first_name` string, nullable — First name.
  - `last_name` string, nullable — Last name.
  - `job_title` string, nullable — Job title.
  - `company_name` string, nullable — Employer name.
  - `company_domain` string, nullable — Employer's primary domain.
  - `icp_context` string, nullable — Description of your ideal customer profile to check the contact against.
  - `criteria` string, nullable — Extra qualification criteria the contact must meet.

## Response `200`

Successful Response

- QualifyContactPublicOutput
  - `verdict` boolean, required — Whether the contact matches the profile and criteria.
  - `score` integer, required — Qualification score out of 100.
  - `reasons` string[], required — Why the verdict was reached, one reason per entry.

---

[API](https://skmtc.net/topo/apis/topo-public-api.md) · [All operations](https://skmtc.net/topo/apis/topo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topo/topo-public-api/revisions/ad6ac1d13526/schema)