GET
/
api
/
v1
/
people
/
lookup
People Lookup
curl --request GET \
  --url https://api.tuesday.so/api/v1/people/lookup \
  --header 'X-API-KEY: <x-api-key>'
{
    "data": {
        "city": "St Petersburg",
        "country": "United States",
        "country_code": "US",
        "country_region": "NORAM",
        "email": "david.addiss@sempersolaris.com",
        "first_name": "David",
        "id": "tu_pacyf3uhs",
        "job_start_date": "2022-04-01",
        "last_name": "Addiss",
        "linkedin_url": "https://www.linkedin.com/in/david-addiss-4725189",
        "mobile_number": "+1 813-407-3977",
        "name": "David Addiss",
        "organization_id": "tu_oac4h5wgp",
        "organizations.founded_year": 2012,
        "organizations.linkedin_url": "https://www.linkedin.com/company/semper-solaris",
        "organizations.name": "Semper Solaris",
        "organizations.primary_domain": "sempersolaris.com",
        "organizations.website_url": "https://www.sempersolaris.com?utm_source=linkedin",
        "seniority": "Staff",
        "state": "Florida",
        "title": "Energy Consultant"
    },
    "statusCode": 200,
    "message": "Success"
}

​
Overview

Find a person’s professional profile when you don’t have their LinkedIn URL but have other identifying information like their name, company domain, title, or location. This endpoint is perfect for lead generation and contact discovery workflows.

​
Authentication

​
X-API-KEY
string
required
Your Tuesday API key

​
Query Parameters

​
company_domain
string
required
Domain of the company (e.g., technova.com, sempersolaris.com)
​
first_name
string
required
First name of the person
​
last_name
string
Last name of the person (optional but recommended for better accuracy)
​
title
string
Job title or role (e.g., “Energy Consultant”, “Software Engineer”)
​
location
string
Location (city, state, or country) (e.g., “Florida”, “New York”, “United States”)
​
include_email
string
default:"exclude"
Include email address in the responseOptions: include | excludeAdditional Cost: +2 credits when set to include
​
include_phone
string
default:"exclude"
Include phone number in the responseOptions: include | excludeAdditional Cost: +3 credits when set to include

​
Response

​
data
object
​
statusCode
number
HTTP status code (200 for success)
​
message
string
Response message

​
Example Requests

curl --location 'https://api.tuesday.so/api/v1/people/lookup?company_domain=sempersolaris.com&first_name=David&last_name=Addiss' \
--header 'X-API-KEY: your-api-key-here'

​
Example Response

{
    "data": {
        "city": "St Petersburg",
        "country": "United States",
        "country_code": "US",
        "country_region": "NORAM",
        "email": "david.addiss@sempersolaris.com",
        "first_name": "David",
        "id": "tu_pacyf3uhs",
        "job_start_date": "2022-04-01",
        "last_name": "Addiss",
        "linkedin_url": "https://www.linkedin.com/in/david-addiss-4725189",
        "mobile_number": "+1 813-407-3977",
        "name": "David Addiss",
        "organization_id": "tu_oac4h5wgp",
        "organizations.founded_year": 2012,
        "organizations.linkedin_url": "https://www.linkedin.com/company/semper-solaris",
        "organizations.name": "Semper Solaris",
        "organizations.primary_domain": "sempersolaris.com",
        "organizations.website_url": "https://www.sempersolaris.com?utm_source=linkedin",
        "seniority": "Staff",
        "state": "Florida",
        "title": "Energy Consultant"
    },
    "statusCode": 200,
    "message": "Success"
}

​
Best Practices

​
Credit Usage

Base Lookup
Email Enrichment
Phone Enrichment

​
Error Responses

​
Use Cases

Lead Generation

Find contact information for prospects when you only know their name and company

CRM Data Cleanup

Enrich incomplete contact records with missing information

Sales Prospecting

Research specific individuals at target companies

Contact Discovery

Find the right person to contact at a company for specific roles