# People

Look up people and their contact data. Use the search endpoints to find people by role, employer, location, or skills; use the detail-lookup endpoints to fetch a full person record by ID, email, or phone number; and use the contacts-lookup endpoints to retrieve work emails, personal emails, or phone numbers for a known person.

## Personal emails lookup

 - [POST /api/{account_id}/datastorage/person_contacts_lookup/personal_emails/](https://docs.forager.ai/openapi/people/datastorage_person_contacts_lookup_personal_emails_create.md): The Person Personal Emails Lookup endpoint retrieves personal email addresses associated with an individual in the Forager dataset. It allows you to input identifying information (such as Linkedin handle or Forager ID) and returns available personal contact emails. The endpoint returns only addresses on free webmail / consumer providers (Gmail, Outlook, Yahoo, iCloud, Proton, and similar). Addresses on corporate domains, educational domains (e.g., .edu, .ac.uk), and any other custom domains are excluded — including custom domains a person uses for personal purposes — to keep deliverability of the returned set high. If the filtered set is empty, the endpoint returns 200 OK with an empty body and does not consume credits.

## Phone numbers lookup

 - [POST /api/{account_id}/datastorage/person_contacts_lookup/phone_numbers/](https://docs.forager.ai/openapi/people/datastorage_person_contacts_lookup_phone_numbers_create.md): The Person Phone Numbers Lookup endpoint retrieves phone numbers associated with an individual in the Forager dataset. It allows you to input identifying information (such as Linkedin handle or Forager ID) and returns available phone numbers. This API is useful for enriching person records, supporting lead generation, and verifying phone contact details within your applications.

## Work emails lookup

 - [POST /api/{account_id}/datastorage/person_contacts_lookup/work_emails/](https://docs.forager.ai/openapi/people/datastorage_person_contacts_lookup_work_emails_create.md): The Person Work Emails Lookup endpoint retrieves work email addresses associated with an individual in the Forager dataset. It allows you to input identifying information (such as Linkedin handle or Forager ID) and returns available work email addresses. This API is useful for enriching person records, supporting lead generation, and verifying work contact details within your applications.

## Person detail lookup

 - [POST /api/{account_id}/datastorage/person_detail_lookup/](https://docs.forager.ai/openapi/people/datastorage_person_detail_lookup_create.md): Do Person details lookup.

## Person detail lookup by email

 - [POST /api/{account_id}/datastorage/person_detail_reverse_lookup/by_email/](https://docs.forager.ai/openapi/people/datastorage_person_detail_reverse_lookup_by_email_create.md): Do reverse lookup of person details by email.

## Person detail lookup by phone

 - [POST /api/{account_id}/datastorage/person_detail_reverse_lookup/by_phone_number/](https://docs.forager.ai/openapi/people/datastorage_person_detail_reverse_lookup_by_phone_number_create.md): Do reverse lookup of person details by phone number.

## Person role search

 - [POST /api/{account_id}/datastorage/person_role_search/](https://docs.forager.ai/openapi/people/datastorage_person_role_search_create.md): The Person Role Search endpoint lets you search for individuals based on their roles, titles, time periods, and associated organizations. You can filter by attributes like role title or description, current status, start/end dates, person name, skills, industry, and location. The response returns matching person records along with their role history and linked organization details (e.g. name, domain, founding date).

## Person role search totals

 - [POST /api/{account_id}/datastorage/person_role_search/totals/](https://docs.forager.ai/openapi/people/datastorage_person_role_search_totals_create.md): Organization person role search totals.