> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Firmable

> Firmable's Partner API enriches company and people records, searches for people within companies, and returns supported search-filter metadata.

![Firmable logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/firmable.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=ab02f77310d7e5875fa74dc470d7f8f5)

* **Category:** business intelligence
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 4
* **Triggers:** 0
* **Slug:** `FIRMABLE`
* **Version:** 00000000\_00

## Tools

> [accordion] Enrich Company
>
> **Slug:** `FIRMABLE_ENRICH_COMPANY`
>
> Look up one enriched company using at least one Firmable, LinkedIn, domain, ABN, or website identifier. This call may consume Firmable credits; Firmable does not publish a per-call cost. Successful enrichment and identifier precedence were not live-verified to avoid consuming credits.
>
> #### Input Parameters
>
> **abn** `string`
>
> Australian Business Number. Provide at least one lookup identifier.
>
> **domain** `string`
>
> Fully qualified company domain without a path, such as example.com. Provide at least one lookup identifier.
>
> **country** `string ("AU" | "NZ" | "SG" | "MY" | "ID" | "PH" | "HK" | "JP" | "VN" | "KR" | "TH" | "US" | "CA")`
>
> Market for region-specific company data. Defaults to AU.
>
> **company\_id** `string`
>
> Firmable company ID, such as f000000117274. Provide at least one lookup identifier.
>
> **website\_url** `string`
>
> Full company website URL. Provide at least one lookup identifier.
>
> **linkedin\_url** `string`
>
> Full company LinkedIn URL. Provide at least one lookup identifier.
>
> **linkedin\_slug** `string`
>
> Company LinkedIn slug. Provide at least one lookup identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enrich Person
>
> **Slug:** `FIRMABLE_ENRICH_PERSON`
>
> Look up one enriched person using a Firmable, LinkedIn, work-email, or personal-email identifier. This request may consume Firmable credits and can return personal contact data; use it only for an authorized purpose. Prefer one strong identifier because precedence between multiple identifiers is not documented or live-verified.
>
> #### Input Parameters
>
> **person\_id** `string`
>
> Firmable person ID, such as fp000000067890. Provide at least one lookup identifier.
>
> **work\_email** `string`
>
> Person's work email address. Provide at least one lookup identifier.
>
> **linkedin\_url** `string`
>
> Full person LinkedIn URL. Provide at least one lookup identifier.
>
> **linkedin\_slug** `string`
>
> Person LinkedIn slug. Provide at least one lookup identifier.
>
> **personal\_email** `string`
>
> Person's personal email address. Provide at least one lookup identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Filter Options
>
> **Slug:** `FIRMABLE_LIST_FILTER_OPTIONS`
>
> Return Firmable's current search filter codes and supported markets, optionally selecting filters or paging one location or industry filter. Firmable explicitly documents this read-only endpoint as not charged.
>
> #### Input Parameters
>
> **offset** `integer`
>
> Number of matching values to skip for exactly one pageable identifier. Omit on the first page and for non-pageable or multiple identifiers; pages contain 20 values.
>
> **search** `string`
>
> Case-insensitive code or label search. Valid only with exactly one of industry, location, hq\_location, or people\_location.
>
> **identifiers** `array`
>
> Filter definitions to return. Accepted identifiers: industry, location, hq\_location, company\_size, global\_company\_size, revenue, company\_type, year\_founded, is\_mnc, b2b\_vs\_b2c, target\_market, multiple\_locations, job\_posts, keywords, services, products, position, seniority, department, skills, current\_role\_duration, and people\_location. Pass an array or comma-separated string; omit to return all definitions.
>
> **level\_one\_code** `string`
>
> Top-level industry code whose second-level codes should be listed. Valid only with identifiers=\[industry].
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People in Company
>
> **Slug:** `FIRMABLE_SEARCH_PEOPLE_IN_COMPANY`
>
> Return one offset-based page of people at a Firmable company, optionally filtered by position, country, seniority code, or department code. Each call may consume Firmable credits and can return personal data; use it only for an authorized purpose. Firmable does not publish a per-call cost.
>
> #### Input Parameters
>
> **offset** `integer`
>
> Zero-based result offset. Pass next\_offset from the prior response to continue.
>
> **country** `string ("AU" | "NZ" | "SG" | "MY" | "ID" | "PH" | "HK" | "JP" | "VN" | "KR" | "TH" | "US" | "CA")`
>
> Market to search. Defaults to AU.
>
> **position** `string`
>
> Job title or position text to match.
>
> **page\_size** `integer`
>
> Number of people requested in this page. Firmable documents no maximum.
>
> **company\_id** `string` *required*
>
> Firmable company ID whose people should be searched.
>
> **seniority\_code** `string ("1" | "2" | "3" | "4" | "5" | "6" | "7")`
>
> Numeric-string seniority code from LIST\_FILTER\_OPTIONS: 1 board/director, 2 owner/founder, 3 C-suite/partner, 4 VP/director/head, 5 manager, 6 other, or 7 no data.
>
> **department\_code** `string ("1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17")`
>
> Numeric-string department code from LIST\_FILTER\_OPTIONS. Use that tool to resolve current labels; documented codes are 1 through 17.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
