API recipes: common B2B data workflows

B2B data workflow: role search returns a person ID, then a phone number lookup returns contact details

This section provides step-by-step API usage examples. Below, you’ll learn how to search for a person by job title, extract their id from the response, and use that ID to perform a phone number lookup.

Search for a Person by Job Title

Use the Person Role Search API to find a person by job title. The request below searches for “Software Engineer”.

Request

curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/person_role_search/" \
     -H "Content-Type: application/json" \
     -H "X-API-KEY: $FORAGER_API_KEY" \
     -d '{
           "role_title": "Software Engineer",
           "role_is_current": true
         }'

Sample Response

Sample response (illustrative values, trimmed)

{
  "search_results": [
    {
      "id": 123456,
      "person": {
        "id": 123,
        "full_name": "John Doe",
        "location": {
          "id": 1,
          "name": "San Francisco, California, United States",
          "osm_locations": []
        }
      },
      "role_title": "Software Engineer",
      "organization": {
        "name": "Tech Corp"
      }
    }
  ],
  "total_search_results": 1
}

Extract the person.id value (123 in this case) for the next step.

Look Up a Person’s Phone Number

Once you have the person.id, use the Person Phone Number Lookup API to retrieve phone number details.

Request

curl -X POST "https://api-v2.forager.ai/api/$FORAGER_ACCOUNT_ID/datastorage/person_contacts_lookup/phone_numbers/" \
     -H "Content-Type: application/json" \
     -H "X-API-KEY: $FORAGER_API_KEY" \
     -d '{
           "person_id": 123
         }'

Sample Response

Sample response (illustrative values)

[
  {
    "phone_number": "+14155552671"
  }
]

Last modified on October 28, 2026

Recipes

Sales and dialer platforms

Recruiting platforms

Data and product teams

AI agents

Sample apps

More examples

API recipes: common B2B data workflows

Search for a Person by Job Title

Request

Sample Response

Look Up a Person’s Phone Number

Request

Sample Response

​Search for a Person by Job Title

​Request

​Sample Response

​Look Up a Person’s Phone Number

​Request

​Sample Response

Search for a Person by Job Title

Request

Sample Response

Look Up a Person’s Phone Number

Request

Sample Response