Firmable: Person Lookup

Returns people information.

Tool ID: firmable_person_lookup

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'firmable_person_lookup',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute firmable_person_lookup --input '{
  "id": "id_123"
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "id": "id_123",
    "name": "Example",
    "first_name": "Jane"
  }
}

Use deepline tools get firmable_person_lookup --json for the latest machine-readable contract.

Input reference

Returns people information

Name	Type	Required	Default	Details
`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/)
`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)

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.id`	`string`	No	—	The Firmable ID of the person.
`result.data.name`	`string`	No	—	The full name of the person.
`result.data.first_name`	`string`	No	—	The first name of the person.
`result.data.last_name`	`string`	No	—	The last name of the person.
`result.data.middle_name`	`string \| null`	No	—	The person’s middle name (if available).
`result.data.headline`	`string`	No	—	A brief professional headline.
`result.data.description`	`string \| null`	No	—	A detailed description of the person.
`result.data.position`	`string \| null`	No	—	The person’s current job position.
`result.data.current_company`	`object`	No	—	Details about the person’s current company.
`result.data.current_company.id`	`string`	No	—	The company’s Firmable ID..
`result.data.current_company.name`	`string`	No	—	The company’s name.
`result.data.current_company.size`	`string`	No	—	The size category of the company.
`result.data.current_company.website`	`string`	No	—	The company’s website URL.
`result.data.current_company.industry`	`array`	No	—	The industries the company operates in.
`result.data.current_company.linkedin`	`string`	No	—	The company’s LinkedIn handle.
`result.data.current_company.main_phones`	`array \| null`	No	—	Main phone numbers for the company..
`result.data.current_company.other_phones`	`array \| null`	No	—	Other phone numbers for the company.
`result.data.current_company.mobile_phones`	`array \| null`	No	—	Mobile phone numbers for the company.
`result.data.time_in_current_role`	`string`	No	—	Duration in the current role.
`result.data.month_joined`	`number`	No	—	The month when the person joined their current role.
`result.data.year_joined`	`integer \| null`	No	—	The year when the person joined their current role.
`result.data.emails`	`object`	No	—	—
`result.data.emails.personal`	`array`	No	—	Details of personal email addresses.
`result.data.emails.personal[].value`	`string`	No	—	The email address.
`result.data.emails.personal[].deliverability`	`string`	No	—	The estimated deliverability of the email.
`result.data.emails.work`	`array`	No	—	Details of work email addresses.
`result.data.emails.work[].value`	`string`	No	—	The email address.
`result.data.emails.work[].deliverability`	`string`	No	—	The estimated deliverability of the email.
`result.data.phones`	`array`	No	—	List of phone numbers with additional details.
`result.data.phones[].value`	`string`	No	—	The phone number.
`result.data.phones[].is_dnd`	`boolean`	No	—	Indicates if the number is on a do-not-disturb list.
`result.data.linkedin`	`string`	No	—	LinkedIn profile handle.
`result.data.social_media`	`object`	No	—	Social media profiles and statistics.
`result.data.social_media.linkedin`	`object \| null`	No	—	LinkedIn profile details (if available).
`result.data.social_media.linkedin.handle`	`string \| null`	No	—	—
`result.data.social_media.linkedin.connections`	`number \| null`	No	—	—
`result.data.social_media.linkedin.followers`	`integer \| null`	No	—	—
`result.data.social_media.linkedin.stars`	`integer \| null`	No	—	—
`result.data.social_media.github`	`object \| null`	No	—	Github profile details (if available).
`result.data.social_media.github.handle`	`string \| null`	No	—	—
`result.data.social_media.github.connections`	`number \| null`	No	—	—
`result.data.social_media.github.followers`	`integer \| null`	No	—	—
`result.data.social_media.github.stars`	`integer \| null`	No	—	—
`result.data.social_media.twitter`	`object \| null`	No	—	Twitter profile details (if available).
`result.data.social_media.twitter.handle`	`string \| null`	No	—	—
`result.data.social_media.twitter.connections`	`number \| null`	No	—	—
`result.data.social_media.twitter.followers`	`integer \| null`	No	—	—
`result.data.social_media.twitter.stars`	`integer \| null`	No	—	—
`result.data.social_media.facebook`	`object \| null`	No	—	Facebook profile details (if available).

The table shows the first 50 fields. Expand the raw schema below for every field.

This output schema is too large to embed without slowing the page. Get the complete live contract with deepline tools get firmable_person_lookup --json.

Deepline cost

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

Get started

Build and automate

Common workflows

Data and integrations

Reference

Firmable: Person Lookup

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation