Search people

Changed on Nov 3, 2026

Search for people based on various filters. Multiple filters within the same field are combined with AND logic.

post/people/search

Request

Base URL
https://app.fullenrich.com/api/v2
URL
https://app.fullenrich.com/api/v2/people/search
Auth
HTTP bearer

Request body

offsetinteger

Number of people to skip (use this for pagination). Maximum value is 10,000. To paginate beyond 10,000 results, use search_after instead.

limitinteger

Number of people to return (default: 10, max: 100)

search_afterstring

Cursor-based pagination. Pass the search_after value from the previous response to get the next page. Works at any point in the result set, but is required to access results beyond the 10,000 offset limit. The search_after token does not have any expiration date. However, when the database is updated (every month), if the position of a contact changes, the same search_after token might display different results.

Example request

{
  "limit": 20,
  "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0=",
  "current_company_names": [
    {
      "value": "Anthropic",
      "exact_match": true,
      "exclude": false
    },
    {
      "value": "OpenAI",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_domains": [
    {
      "value": "google.com",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_professional_network_ids": [
    {
      "value": 1234,
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_professional_network_urls": [
    {
      "value": "https://www.linkedin.com/company/fullenrich",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_specialties": [
    {
      "value": "artificial intelligence",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_industries": [
    {
      "value": "Software Development",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "Computer Hardware Manufacturing",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_company_technologies": [
    {
      "value": "Notion",
      "exact_match": false,
      "exclude": false
    }
  ],
  "past_company_names": [
    {
      "value": "Meta",
      "exact_match": true,
      "exclude": false
    }
  ],
  "past_company_domains": [
    {
      "value": "facebook.com",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_types": [
    {
      "value": "Public Company",
      "exact_match": true,
      "exclude": false
    }
  ],
  "current_company_headquarters": [
    {
      "value": "San Francisco",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "New York",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_company_headcounts": [
    {
      "min": 50,
      "max": 200,
      "exclude": false
    },
    {
      "min": 1000,
      "max": 5000,
      "exclude": false
    }
  ],
  "current_company_founded_years": [
    {
      "min": 2020,
      "max": 2024,
      "exclude": false
    }
  ],
  "current_company_ids": [
    {
      "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "exact_match": true
    }
  ],
  "person_ids": [
    {
      "value": "746e4816-19c8-54d8-b558-65a5a52cc85c",
      "exact_match": true
    }
  ],
  "person_names": [
    {
      "value": "John Smith",
      "exact_match": false,
      "exclude": false
    }
  ],
  "person_professional_network_ids": [
    {
      "value": 1234,
      "exact_match": true,
      "exclude": false
    }
  ],
  "person_professional_network_urls": [
    {
      "value": "https://www.linkedin.com/in/john-doe",
      "exact_match": true,
      "exclude": false
    }
  ],
  "person_locations": [
    {
      "value": "San Francisco",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "California",
      "exact_match": false,
      "exclude": false
    }
  ],
  "person_languages": [
    {
      "value": "English",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "French",
      "exact_match": false,
      "exclude": false
    }
  ],
  "person_skills": [
    {
      "value": "JavaScript",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "Python",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "Project Management",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_seniority_level": [
    {
      "value": "Director",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "VP",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_job_functions": [
    {
      "value": "Software Development",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_sub_functions": [
    {
      "value": "Freelancer",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_titles": [
    {
      "value": "Chief Technology Officer",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "VP of Engineering",
      "exact_match": false,
      "exclude": false
    }
  ],
  "past_position_titles": [
    {
      "value": "Software Engineer",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_position_years_in": [
    {
      "min": 0,
      "max": 1,
      "exclude": false
    }
  ],
  "current_company_years_at": [
    {
      "min": 2,
      "max": 5,
      "exclude": false
    }
  ],
  "person_universities": [
    {
      "value": "Stanford University",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "MIT",
      "exact_match": false,
      "exclude": false
    }
  ],
  "current_company_days_since_last_job_change": [
    {
      "min": 0,
      "max": 90,
      "exclude": false
    }
  ]
}

Response

Example response

{
  "people": [
    {
      "id": "746e4816-19c8-54d8-b558-65a5a52cc85c",
      "full_name": "Enzo Romera",
      "first_name": "Enzo",
      "last_name": "Romera",
      "headline": "Marketing Strategist | 10+ Years in Strategy, Account Management & Activation | Consulting Expert",
      "description": "Marketing strategist with 10+ years helping B2B companies build demand generation engines. I work with go-to-market teams on positioning, account-based campaigns and channel activation.",
      "location": {
        "country": "United States",
        "country_code": "US",
        "city": "San Francisco",
        "region": "California"
      },
      "social_profiles": {
        "professional_network": {
          "id": 1234,
          "url": "https://www.linkedin.com/in/john-doe",
          "handle": "john-doe",
          "connection_count": 500
        }
      },
      "educations": [
        {
          "school_name": "Stanford University",
          "degree": "Bachelor of Science in Computer Science",
          "start_at": "2015-09-01T00:00:00Z",
          "end_at": "2019-06-01T00:00:00Z"
        }
      ],
      "languages": [
        {
          "language": "French",
          "proficiency": "NATIVE_OR_BILINGUAL"
        }
      ],
      "skills": [
        "JavaScript",
        "Project Management",
        "Python"
      ],
      "employment": {
        "current": {
          "title": "Senior Software Engineer",
          "seniority": "Senior",
          "job_functions": [
            {
              "function": "Not Employed",
              "sub_function": "Freelancer"
            }
          ],
          "description": "Leading the backend team and designing microservices architecture.",
          "company": {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Anthropic",
            "domain": "anthropic.com",
            "website": "https://www.anthropic.com",
            "description": "AI safety and research company",
            "year_founded": 2021,
            "headcount": 2610,
            "headcount_range": "1001-5000",
            "company_type": "Privately Held",
            "specialties": [
              "Data Enrichment",
              "B2B Data"
            ],
            "technologies": [
              {
                "name": "Fullenrich",
                "logo_url": "https://app.fullenrich.com/logo/technologies/id/3uwxkma9y03lj"
              }
            ],
            "locations": {
              "headquarters": {
                "line1": "548 Market St",
                "line2": "San Francisco, CA 94105, US",
                "city": "San Francisco",
                "region": "California",
                "country": "United States",
                "country_code": "US"
              },
              "offices": [
                {
                  "line1": "111 8th Ave",
                  "line2": "New York, NY 10011, US"
                }
              ]
            },
            "industry": {
              "main_industry": "Software Development"
            },
            "social_profiles": {
              "professional_network": {
                "id": 1234,
                "url": "https://www.linkedin.com/company/anthropic",
                "handle": "anthropic",
                "connection_count": 125000
              }
            },
            "logo_url": "https://app.fullenrich.com/logo/company/handle/anthropic"
          },
          "is_current": true,
          "start_at": "2022-03-15T00:00:00Z",
          "end_at": "2024-06-30T00:00:00Z"
        },
        "all": [
          {
            "title": "Senior Software Engineer",
            "seniority": "Senior",
            "job_functions": [
              {
                "function": "Not Employed",
                "sub_function": "Freelancer"
              }
            ],
            "description": "Leading the backend team and designing microservices architecture.",
            "company": {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "name": "Anthropic",
              "domain": "anthropic.com",
              "website": "https://www.anthropic.com",
              "description": "AI safety and research company",
              "year_founded": 2021,
              "headcount": 2610,
              "headcount_range": "1001-5000",
              "company_type": "Privately Held",
              "specialties": [
                "Data Enrichment",
                "B2B Data"
              ],
              "technologies": [
                {
                  "name": "Fullenrich",
                  "logo_url": "https://app.fullenrich.com/logo/technologies/id/3uwxkma9y03lj"
                }
              ],
              "locations": {
                "headquarters": {
                  "line1": "548 Market St",
                  "line2": "San Francisco, CA 94105, US",
                  "city": "San Francisco",
                  "region": "California",
                  "country": "United States",
                  "country_code": "US"
                },
                "offices": [
                  {
                    "line1": "111 8th Ave",
                    "line2": "New York, NY 10011, US"
                  }
                ]
              },
              "industry": {
                "main_industry": "Software Development"
              },
              "social_profiles": {
                "professional_network": {
                  "id": 1234,
                  "url": "https://www.linkedin.com/company/anthropic",
                  "handle": "anthropic",
                  "connection_count": 125000
                }
              },
              "logo_url": "https://app.fullenrich.com/logo/company/handle/anthropic"
            },
            "is_current": true,
            "start_at": "2022-03-15T00:00:00Z",
            "end_at": "2024-06-30T00:00:00Z"
          }
        ]
      }
    }
  ],
  "metadata": {
    "total": 20523,
    "credits": 22.5,
    "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0="
  }
}

Changes

Nov 3, 202629391d7e33f8 Revision changes
- info
  added the new optional request property
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ////// to the response with the status

Operation history