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 response

Options: include | exclude

Additional Cost: +2 credits when set to include

​
include_phone
string
default:"exclude"

Include phone number in the response

Options: include | exclude

Additional 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