GET
/
api
/
v1
/
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": "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

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 person

Example: https://www.linkedin.com/in/david-addiss-4725189

​
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/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": "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"
}

​
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

​
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