Get People Profile

curl --request GET \
  --url https://api.tuesday.so/api/v1/people/profile \
  --header 'X-API-KEY: <x-api-key>'

{
    "data": {
        "city": "St Petersburg",
        "country": "United States",
        "country_code": "US",
        "country_region": "NORAM",
        "email": "[email protected]",
        "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"
}

GET

https://api.tuesday.so

api

people

profile

Get People Profile

curl --request GET \
  --url https://api.tuesday.so/api/v1/people/profile \
  --header 'X-API-KEY: <x-api-key>'

{
    "data": {
        "city": "St Petersburg",
        "country": "United States",
        "country_code": "US",
        "country_region": "NORAM",
        "email": "[email protected]",
        "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

Get comprehensive profile information for a person using their LinkedIn URL. This endpoint provides basic profile data and can be enriched with email addresses and phone numbers for additional credits.

Authentication

X-API-KEY

string

required

Your Tuesday API key

Query Parameters

linkedin_url

string

required

LinkedIn profile URL of the personExample: https://www.linkedin.com/in/david-addiss-4725189

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

Show Person Profile Data

string

Unique identifier for the person

name

string

Full name of the person

first_name

string

First name

last_name

string

Last name

title

string

Current job title

seniority

string

Seniority level (e.g., “Staff”, “Manager”, “Director”)

linkedin_url

string

LinkedIn profile URL

job_start_date

string

Start date of current position (YYYY-MM-DD format)

city

string

Current city

state

string

Current state/region

country

string

Current country

country_code

string

Two-letter country code

country_region

string

Geographic region (e.g., “NORAM”, “EMEA”, “APAC”)

string

Email address (only when include_email=include)

mobile_number

string

Phone number (only when include_phone=include)

organization_id

string

Unique identifier for the person’s current organization

organizations.name

string

Current organization name

organizations.linkedin_url

string

Organization’s LinkedIn URL

organizations.primary_domain

string

Organization’s primary domain

organizations.website_url

string

Organization’s website URL

organizations.founded_year

number

Year the organization was founded

statusCode

number

HTTP status code (200 for success)

message

string

Response message

Example Requests

curl --location 'https://api.tuesday.so/api/v1/people/profile?linkedin_url=https://www.linkedin.com/in/david-addiss-4725189' \
--header 'X-API-KEY: your-api-key-here'

Example Response

{
    "data": {
        "city": "St Petersburg",
        "country": "United States",
        "country_code": "US",
        "country_region": "NORAM",
        "email": "[email protected]",
        "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"
}

Credit Usage

Base Profile

Email Enrichment

Phone Enrichment

Examples:

Basic profile: 1 credit
Profile + email: 3 credits (1 + 2)
Profile + phone: 4 credits (1 + 3)
Profile + email + phone: 6 credits (1 + 2 + 3)

Error Responses

400 Bad Request - Missing LinkedIn URL

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "Missing required parameter: linkedin_url"
}

400 Bad Request - Invalid LinkedIn URL

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "Invalid LinkedIn URL format"
}

404 Not Found - Profile Not Found

{
    "statusCode": 404,
    "message": "Not Found",
    "error": "Profile not found for the provided LinkedIn URL"
}

402 Insufficient Credits

{
    "statusCode": 402,
    "message": "Insufficient credits",
    "error": "Not sufficient credit available for request"
}

Use Cases

CRM Enrichment

Enrich existing contact records with verified profile information

Lead Qualification

Research prospects before outreach to personalize messaging

Contact Discovery

Find contact information for specific individuals

Due Diligence

Verify professional information for business purposes

People Lookup API - Find people by attributes like name and company
People Search API - Search for people using advanced filters
Reverse Email Lookup - Find profile by email address

Check API Key People Lookup

⌘I

Authentication

People APIs

Company APIs

Get People Profile

Overview

Authentication

Query Parameters

Response

Example Requests

Example Response

Credit Usage

Error Responses

Use Cases

CRM Enrichment

Lead Qualification

Contact Discovery

Due Diligence

Authentication

People APIs

Company APIs

​Overview

​Authentication

​Query Parameters

​Response

​Example Requests

​Example Response

​Credit Usage

​Error Responses

​Use Cases

CRM Enrichment

Lead Qualification

Contact Discovery

Due Diligence

​Related Endpoints

Overview

Authentication

Query Parameters

Response

Example Requests

Example Response

Credit Usage

Error Responses

Use Cases

Related Endpoints