# Recipes

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


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

### Sample Response


```bash
{
  "search_results": [
    {
      "id": 123456,
      "person": {
        "id": 123,
        "full_name": "John Doe",
        "location": "San Francisco, CA"
      },
      "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


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

### Sample Response


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