Firmable: Person Lookup

Get a person’s profile from their LinkedIn URL, work email or personal email.

Tool ID: firmable_person_lookup

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

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 returns this shape at result.toolResponse.raw. The example values illustrate the response.

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

Use deepline describe 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 for an inline display. Read the complete live contract with deepline describe firmable_person_lookup --json.

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 3.57 per pricing unit.

​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