---
title: "Lookup Contact"
method: POST
path: "/v1/contacts/lookup"
tags: ["contacts"]
---

# Lookup Contact

`POST /v1/contacts/lookup`

## Request

- Base URL: `https://api.topo.io`
- URL: `https://api.topo.io/v1/contacts/lookup`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/topo/apis/topo-public-api/docs/v1/contacts/lookup/post.ts> (a function with typed inputs; its response is checked against the schema)

Look a person up in Topo's lead database.

The LinkedIn URL is the surest match, then the email, then the first and
last name with the current employer's name or domain. The profile and
current employer are returned without any email or phone number. Nothing
is written to the workspace and no credit is spent — use
`POST /v1/contacts/enrich` to find an email and save the contact.

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

## Request body

- LookupContactPublicInput
  - `linkedin_url` string, nullable: LinkedIn profile URL, the surest match.
  - `email` string, nullable: Email.
  - `first_name` string, nullable: First name, matched with `last_name` and the employer.
  - `last_name` string, nullable: Last name.
  - `company_name` string, nullable: Current employer name.
  - `company_domain` string, nullable: Current employer's primary domain.

## Response `200`

Successful Response

- LookupContactPublicOutput
  - `found` boolean, required: Whether Topo's lead database holds a matching profile.
  - `first_name` string, nullable: First name.
  - `last_name` string, nullable: Last name.
  - `job_title` string, nullable: Job title.
  - `headline` string, nullable: Profile headline.
  - `location` string, nullable: Location.
  - `seniority` string, nullable: Seniority.
  - `department` string, nullable: Department.
  - `years_of_experience` integer, nullable: Years of professional experience.
  - `linkedin_url` string, nullable: LinkedIn profile URL.
  - `profile_picture_url` string, nullable: Profile picture URL.
  - `company_name` string, nullable: Current employer name.
  - `company_domain` string, nullable: Current employer's primary domain.
  - `company_linkedin_url` string, nullable: Current employer's LinkedIn page URL.
  - `company_industry` string, nullable: Current employer's industry.
  - `company_employee_count` integer, nullable: Current employer's headcount.
  - `company_country` string, nullable: Current employer's headquarters country.

## Changes

- **2026-10-27** `cf646588128e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/topo/apis/topo-public-api/changes/v1/contacts/lookup/post.md)

---

[API](https://skmtc.dev/topo/apis/topo-public-api.md) - [All operations](https://skmtc.dev/topo/apis/topo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/topo/apis/topo-public-api/revisions/1eb3139a398e?raw)