> ## 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: Company Lookup

> Get a company's profile from its LinkedIn URL, website, domain or Australian Business Number. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Get a company's profile from its LinkedIn URL, website, domain or Australian Business Number.

> [!NOTE]
>
> Tool ID: `firmable_company_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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

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

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute firmable_company_lookup --input '{
  "id": "id_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "id": "id_123",
    "name": "Example",
    "website": "https://example.com"
  }
}
```

Use `deepline describe firmable_company_lookup --json` for the latest machine-readable contract.

## Input reference

Returns company information

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | No | — | The Firmable ID of the company (example: f000000117274) |
| `payload.ln_slug` | `string` | No | — | The LinkedIn slug of the company (example: smec) |
| `payload.ln_url` | `string` | No | — | LinkedIn URL of the company (example: [https://www.linkedin.com/company/smec/](https://www.linkedin.com/company/smec/)) |
| `payload.fqdn` | `string` | No | — | FQDN of the company (example: smec.com) |
| `payload.abn` | `string` | No | — | ABN of the company (example: 47065475149) |
| `payload.website` | `string` | No | — | Website of the company (example: [https://www.smec.com](https://www.smec.com)) |
| `payload.country` | `"AU" \| "NZ" \| "SG" \| "MY" \| "ID" \| "PH" \| "HK" \| "JP" \| "VN" \| "KR" \| "TH" \| "US" \| "CA"` | No | — | ISO country code to return region-specific data for. Supported values: AU, NZ, SG, MY, ID, PH, HK, JP, VN, KR, TH, US, CA. Defaults to AU when not provided. Allowed: `AU`, `NZ`, `SG`, `MY`, `ID`, `PH`, `HK`, `JP`, `VN`, `KR`, `TH`, `US`, `CA`. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Returns company information",
    "properties": {
      "id": {
        "type": "string",
        "description": "The Firmable ID of the company (example: f000000117274)"
      },
      "ln_slug": {
        "type": "string",
        "description": "The LinkedIn slug of the company (example: smec)"
      },
      "ln_url": {
        "type": "string",
        "description": "LinkedIn URL of the company (example: https://www.linkedin.com/company/smec/)"
      },
      "fqdn": {
        "type": "string",
        "description": "FQDN of the company (example: smec.com)"
      },
      "abn": {
        "type": "string",
        "description": "ABN of the company (example: 47065475149)"
      },
      "website": {
        "type": "string",
        "description": "Website of the company (example: https://www.smec.com)"
      },
      "country": {
        "type": "string",
        "description": "ISO country code to return region-specific data for. Supported values: AU, NZ, SG, MY, ID, PH, HK, JP, VN, KR, TH, US, CA. Defaults to AU when not provided.",
        "enum": [
          "AU",
          "NZ",
          "SG",
          "MY",
          "ID",
          "PH",
          "HK",
          "JP",
          "VN",
          "KR",
          "TH",
          "US",
          "CA"
        ]
      }
    },
    "required": [],
    "anyOf": [
      {
        "required": [
          "id"
        ]
      },
      {
        "required": [
          "ln_slug"
        ]
      },
      {
        "required": [
          "ln_url"
        ]
      },
      {
        "required": [
          "fqdn"
        ]
      },
      {
        "required": [
          "abn"
        ]
      },
      {
        "required": [
          "website"
        ]
      }
    ],
    "additionalProperties": false
  }
  ```
</details>

## 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 company. |
| `result.data.name` | `string` | No | — | The name of the company. |
| `result.data.website` | `string` | No | — | The company's website URL. |
| `result.data.fqdn` | `string` | No | — | The fully qualified domain name of the company's website. |
| `result.data.description` | `string` | No | — | A detailed description of the company. |
| `result.data.tagline` | `string` | No | — | A brief tagline or slogan for the company. |
| `result.data.linkedin` | `string` | No | — | The company's LinkedIn handle. |
| `result.data.employee_count` | `integer \| null` | No | — | The number of employees in the requested country region. |
| `result.data.year_founded` | `integer` | No | — | The year the company was founded. |
| `result.data.hq_location` | `string \| null` | No | — | The headquarters location of the company. |
| `result.data.hq_country` | `string` | No | — | The country of the company's headquarters. |
| `result.data.company_size` | `string` | No | — | The size category of the company. |
| `result.data.company_type` | `string` | No | — | The type of company (e.g., Private, Public). |
| `result.data.abn_operation_status` | `string` | No | — | The operational status of the company's ABN. |
| `result.data.locations` | `array` | No | — | The locations associated with the company. |
| `result.data.industries` | `array` | No | — | The industries associated with the company. |
| `result.data.revenue` | `string` | No | — | The company's revenue, if available. |
| `result.data.phones` | `array` | No | — | List of phone numbers associated with the company. |
| `result.data.emails` | `array` | No | — | List of email addresses associated with the company. |
| `result.data.social_media` | `object` | No | — | Social media profiles of the company. |
| `result.data.social_media.twitter` | `string \| null` | No | — | Twitter handle of the company. |
| `result.data.social_media.youtube` | `string \| null` | No | — | Youtube channel of the company. |
| `result.data.social_media.facebook` | `string \| null` | No | — | Facebook page of the company. |
| `result.data.social_media.linkedin` | `string \| null` | No | — | LinkedIn profile of the company. |
| `result.data.social_media.instagram` | `string \| null` | No | — | Instagram handle of the company. |
| `result.data.industry_codes` | `object` | No | — | Industry classification and business identifier codes for the company. Always includes global codes (sic, duns, naics, anzsic) where available. Also includes country-specific business identifiers depending on the requested region — for example: abn and acn for AU, nzbn for NZ, uen for SG. Additional identifiers may be present for other supported countries (MY, ID, PH, HK, JP, VN, KR, TH, US, CA). |
| `result.data.industry_codes.sic` | `string \| null` | No | — | Standard Industrial Classification code. |
| `result.data.industry_codes.duns` | `string \| null` | No | — | Data Universal Numbering System number. |
| `result.data.industry_codes.naics` | `string \| null` | No | — | North American Industry Classification System code. |
| `result.data.industry_codes.anzsic` | `string \| null` | No | — | Australian and New Zealand Standard Industrial Classification code. |
| `result.data.industry_codes.abn` | `string \| null` | No | — | Australian Business Number (AU only). |
| `result.data.industry_codes.acn` | `string \| null` | No | — | Australian Company Number (AU only). |
| `result.data.industry_codes.nzbn` | `string \| null` | No | — | New Zealand Business Number (NZ only). |
| `result.data.industry_codes.uen` | `string \| null` | No | — | Unique Entity Number (SG only). |
| `result.data.keywords` | `array` | No | — | Keywords associated with the company. |
| `result.data.org_registers` | `record` | No | — | Information about organizational registers. |
| `result.data.states` | `array` | No | — | Additional state information about the company. |
| `result.data.nextGen` | `object` | No | — | Next-generation data about the company. |
| `result.data.nextGen.technographics` | `record` | No | — | Technographics profile of the company. |
| `result.data.nextGen.website` | `string` | No | — | The company's website URL. |
| `result.data.nextGen.social_media` | `object` | No | — | Detailed social media information. |
| `result.data.nextGen.social_media.youtube` | `object` | No | — | YouTube channel details. |
| `result.data.nextGen.social_media.youtube.profile_name` | `string` | No | — | — |
| `result.data.nextGen.social_media.youtube.handle` | `string` | No | — | — |
| `result.data.nextGen.social_media.youtube.followers` | `integer \| null` | No | — | — |
| `result.data.nextGen.social_media.youtube.verified` | `string \| null` | No | — | — |
| `result.data.nextGen.social_media.youtube.videos` | `integer \| null` | No | — | — |
| `result.data.nextGen.social_media.youtube.likes` | `integer \| null` | No | — | — |
| `result.data.nextGen.social_media.youtube.views` | `integer \| null` | No | — | — |

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

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe firmable_company_lookup --json`.

## Deepline cost

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

## Related documentation

* [Firmable provider guide](https://deepline.com/docs/providers/firmable/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.