> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Firmable Person Lookup: Inputs, Cost & CLI Example

> Returns people information. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=firmable_person_lookup:{}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name                     | Type     | Required | Default | Description                                                                                                                   |
| ------------------------ | -------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `payload.id`             | `string` | No       |         | The unique identifier for a person in the Firmable system. (example: fp000000067890)                                          |
| `payload.ln_slug`        | `string` | No       |         | The LinkedIn slug of the person. (example: chathchw)                                                                          |
| `payload.ln_url`         | `string` | No       |         | The full LinkedIn URL of the person (example: [https://www.linkedin.com/in/chathchw/](https://www.linkedin.com/in/chathchw/)) |
| `payload.work_email`     | `string` | No       |         | Work email of the person (example: \*\*\*\*\*\*@firmable.com)                                                                 |
| `payload.personal_email` | `string` | No       |         | Personal email of the person (example: \*\*\*\*\*\*@gmail.com)                                                                |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Returns people information",
    "properties": {
      "id": {
        "type": "string",
        "description": "The unique identifier for a person in the Firmable system. (example: fp000000067890)"
      },
      "ln_slug": {
        "type": "string",
        "description": "The LinkedIn slug of the person. (example: chathchw)"
      },
      "ln_url": {
        "type": "string",
        "description": "The full LinkedIn URL of the person (example: https://www.linkedin.com/in/chathchw/)"
      },
      "work_email": {
        "type": "string",
        "description": "Work email of the person (example: ******@firmable.com)"
      },
      "personal_email": {
        "type": "string",
        "description": "Personal email of the person (example: ******@gmail.com)"
      }
    },
    "required": [],
    "anyOf": [
      {
        "required": [
          "id"
        ]
      },
      {
        "required": [
          "ln_slug"
        ]
      },
      {
        "required": [
          "ln_url"
        ]
      },
      {
        "required": [
          "work_email"
        ]
      },
      {
        "required": [
          "personal_email"
        ]
      }
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `result.meta` | `object` | No       |         | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "id": {
            "type": "string",
            "description": "The Firmable ID of the person."
          },
          "name": {
            "type": "string",
            "description": "The full name of the person."
          },
          "first_name": {
            "type": "string",
            "description": "The first name of the person."
          },
          "last_name": {
            "type": "string",
            "description": "The last name of the person."
          },
          "middle_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "The person's middle name (if available)."
          },
          "headline": {
            "type": "string",
            "description": "A brief professional headline."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "A detailed description of the person."
          },
          "position": {
            "type": [
              "string",
              "null"
            ],
            "description": "The person's current job position."
          },
          "current_company": {
            "type": "object",
            "description": "Details about the person's current company.",
            "properties": {
              "id": {
                "type": "string",
                "description": "The company's Firmable ID.."
              },
              "name": {
                "type": "string",
                "description": "The company's name."
              },
              "size": {
                "type": "string",
                "description": "The size category of the company."
              },
              "website": {
                "type": "string",
                "description": "The company's website URL."
              },
              "industry": {
                "type": "array",
                "description": "The industries the company operates in.",
                "items": {
                  "type": "string"
                }
              },
              "linkedin": {
                "type": "string",
                "description": "The company's LinkedIn handle."
              },
              "main_phones": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "Main phone numbers for the company..",
                "items": {
                  "type": "string"
                }
              },
              "other_phones": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "Other phone numbers for the company.",
                "items": {
                  "type": "string"
                }
              },
              "mobile_phones": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "Mobile phone numbers for the company.",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          },
          "time_in_current_role": {
            "type": "string",
            "description": "Duration in the current role."
          },
          "month_joined": {
            "type": "number",
            "description": "The month when the person joined their current role."
          },
          "year_joined": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The year when the person joined their current role."
          },
          "emails": {
            "type": "object",
            "properties": {
              "personal": {
                "type": "array",
                "description": "Details of personal email addresses.",
                "items": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": "string",
                      "description": "The email address."
                    },
                    "deliverability": {
                      "type": "string",
                      "description": "The estimated deliverability of the email."
                    }
                  },
                  "additionalProperties": false
                }
              },
              "work": {
                "type": "array",
                "description": "Details of work email addresses.",
                "items": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": "string",
                      "description": "The email address."
                    },
                    "deliverability": {
                      "type": "string",
                      "description": "The estimated deliverability of the email."
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          },
          "phones": {
            "type": "array",
            "description": "List of phone numbers with additional details.",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "The phone number."
                },
                "is_dnd": {
                  "type": "boolean",
                  "description": "Indicates if the number is on a do-not-disturb list."
                }
              },
              "additionalProperties": false
            }
          },
          "linkedin": {
            "type": "string",
            "description": "LinkedIn profile handle."
          },
          "social_media": {
            "type": "object",
            "description": "Social media profiles and statistics.",
            "properties": {
              "linkedin": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "LinkedIn profile details (if available).",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "connections": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "followers": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "stars": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "github": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Github profile details (if available).",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "connections": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "followers": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "stars": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "twitter": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Twitter profile details (if available).",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "connections": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "followers": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "stars": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "facebook": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Facebook profile details (if available).",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "connections": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "followers": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "stars": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "youtube": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Youtube profile details (if available).",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "connections": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "followers": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "stars": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "pintrest": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Pinterest profile details (if available).",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "connections": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "followers": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "stars": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "location": {
            "type": "array",
            "description": "The person's location information.",
            "items": {
              "type": "string"
            }
          },
          "department": {
            "type": "string",
            "description": "The person's department information."
          },
          "seniority": {
            "type": "string",
            "description": "Information about the person's seniority level."
          },
          "gender": {
            "type": "string",
            "description": "Information about the person's gender."
          },
          "skills": {
            "type": [
              "array",
              "null"
            ],
            "description": "List of professional skills.",
            "items": {
              "type": "string"
            }
          },
          "education": {
            "type": "object",
            "description": "List of educational qualifications.",
            "properties": {
              "field": {
                "type": "string",
                "description": "The field of study."
              },
              "degree": {
                "type": "string",
                "description": "Degree obtained."
              },
              "date_range": {
                "type": "string",
                "description": "Duration of the education."
              },
              "school_name": {
                "type": "string",
                "description": "Name of the educational institution.."
              }
            },
            "additionalProperties": false
          },
          "keywords": {
            "type": [
              "array",
              "null"
            ],
            "description": "Keywords associated with the person (if available).",
            "items": {
              "type": "string"
            }
          },
          "secondary_position": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "description": "Information about secondary positions.",
              "properties": {
                "company_id": {
                  "type": "string",
                  "description": "The Firmable ID of the company."
                },
                "company_name": {
                  "type": "string",
                  "description": "The name of the company."
                },
                "company_size": {
                  "type": "string",
                  "description": "The size category of the company."
                },
                "company_website": {
                  "type": "string",
                  "description": "The company's website URL."
                },
                "company_linkedin": {
                  "type": "string",
                  "description": "The company's LinkedIn handle."
                },
                "company_industry": {
                  "type": "string",
                  "description": "The primary industry of the company."
                },
                "cleaned_position": {
                  "type": "string",
                  "description": "A standardised version of the job title."
                },
                "month_joined": {
                  "type": "number",
                  "description": "The month when the person joined this role."
                },
                "year_joined": {
                  "type": "number",
                  "description": "The year when the person joined this role."
                },
                "time_in_current_role": {
                  "type": "string",
                  "description": "Duration in this role."
                },
                "seniority": {
                  "type": "string",
                  "description": "The seniority level of this position."
                },
                "department": {
                  "type": "string",
                  "description": "The department of this position."
                }
              },
              "additionalProperties": false
            }
          },
          "country": {
            "type": "string",
            "description": "Country code returned by Firmable."
          },
          "slug": {
            "type": "string",
            "description": "Firmable person slug."
          },
          "urn": {
            "type": "string",
            "description": "Provider profile URN."
          },
          "experience": {
            "type": "array",
            "description": "Employment history returned by Firmable.",
            "items": {
              "type": "object",
              "properties": {
                "company": {
                  "type": "string"
                },
                "positions": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "date_range": {
                        "type": "string"
                      },
                      "location": {
                        "type": "string"
                      },
                      "position": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  }
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute firmable_person_lookup --payload '{}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.