GET /people
Bearer auth

Retrieve contact information for a person by their LinkedIn ID, LinkedIn public identifier, GitHub ID, or GitHub login.

Query parameters

  • linkedin_id integer

    LinkedIn ID to search by

  • linkedin_public_identifier string

    LinkedIn public identifier (username) to search by

  • github_id integer

    GitHub ID to search by

  • github_login string

    GitHub login (username) to search by

Responses

  • 200 application/json

    Profile found successfully

    Hide response attributes Show response attributes object
    • linkedin_id integer | null

      LinkedIn ID

    • linkedin_public_identifier string | null

      LinkedIn public identifier (username)

    • github_id integer | null

      GitHub ID

    • github_login string | null

      GitHub login (username)

    • email_addresses array[string(email)]

      List of known email addresses

    • phone_numbers array[string]

      List of known phone numbers

    • github_username string | null

      GitHub username

    • facebook_username string | null

      Facebook username

    • twitter_username string | null

      Twitter/X username
  • 400 application/json

    Bad request - missing required parameters

    Hide response attribute Show response attribute object
    • error string Required

      Error message
  • 401 application/json

    Unauthorized - invalid or missing bearer token

    Hide response attribute Show response attribute object
    • error string Required

      Error message
  • 404 application/json

    No profile found for the given parameters

    Hide response attribute Show response attribute object
    • error string Required

      Error message
GET /people 
curl \
 --request GET 'https://peopledb.co/api/v1/people' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "linkedin_id": 123456789,
  "linkedin_public_identifier": "johndoe",
  "github_id": 12345,
  "github_login": "johndoe",
  "email_addresses": [
    "john.doe@example.com",
    "johndoe@company.com"
  ],
  "phone_numbers": [
    "+1-555-123-4567"
  ],
  "github_username": "johndoe",
  "facebook_username": "john.doe",
  "twitter_username": "johndoe"
}
Response examples (400) 
{
  "error": "One of linkedin_id, linkedin_public_identifier, github_id, or github_login is required"
}
Response examples (401) 
{
  "error": "Unauthorized"
}
Response examples (404) 
{
  "error": "No profile found for the given parameters"
}