GET
/
v1
/
persons
Search persons
curl --request GET \
  --url https://api.stardex.ai/v1/persons \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "John Doe",
      "linkedin_public_id": "johndoe",
      "first_name": "John",
      "last_name": "Doe",
      "current_job_title": "Software Engineer",
      "current_company_name": "Tech Corp",
      "current_company_id": "456e7890-e12b-34d5-a678-901234567890",
      "external_source_id": null,
      "emails": [
        {
          "contact_data_type": "work",
          "value": "john@company.com"
        }
      ],
      "phones": [
        {
          "contact_data_type": "mobile",
          "value": "+1234567890"
        }
      ],
      "work_experience": [
        {
          "positions": [
            {
              "title": "Software Engineer",
              "start_date": "2021-01-01",
              "end_date": null,
              "duration_in_months": 36,
              "description": "Full-stack development",
              "location": "San Francisco, CA",
              "position_type": "Full-time"
            }
          ],
          "duration_in_months": 36,
          "company_name": "Tech Corp",
          "company_linkedin_url": "https://www.linkedin.com/company/tech-corp",
          "company_linkedin_id": 123456,
          "company_id": "456e7890-e12b-34d5-a678-901234567890"
        }
      ],
      "education_experience": [
        {
          "company_name": "University of Somewhere",
          "start_date": "2014-09-01",
          "end_date": "2018-06-01",
          "description": "BSc in Computer Science",
          "degree": "BSc Computer Science",
          "company_linkedin_url": "https://www.linkedin.com/school/university-of-somewhere",
          "company_linkedin_id": 987654,
          "company_id": null
        }
      ],
      "certifications": [
        {
          "name": "AWS Certified Solutions Architect",
          "credential_id": "ABC-123",
          "start_date": "2022-01-01",
          "end_date": "2025-01-01",
          "company_name": "Amazon Web Services",
          "company_linkedin_url": "https://www.linkedin.com/company/amazon-web-services",
          "company_linkedin_id": 1586,
          "company_id": null
        }
      ]
    }
  ],
  "meta": {
    "total": 100,
    "offset": 0,
    "limit": 20
  }
}

Authorizations

Authorization
string
header
required

Enter your API key as: Bearer your_api_key_here

Query Parameters

offset
integer | null
default:0

Number of records to skip

Required range: x >= 0
limit
integer
default:100

Maximum number of records to return (1-100)

Required range: 1 <= x <= 100
email
string<email>

Email address to search for

name
string

Name to search for

phone
string

Phone number to search for

linkedin_url
string<uri>

LinkedIn URL to search for

Vector search query. Example: VP ops that have strategy consulting experience

Minimum length: 5

Response

Successful response

The response is of type object.