Skip to main content
GET
/
company
cURL
curl --request GET \
  --url https://api.firmable.com/company \
  --header 'Authorization: Bearer <token>'
{
  "id": "f0000067890",
  "name": "The name of the company.",
  "website": "https://www.example.com",
  "fqdn": "firmable.com",
  "description": "CommBank offers personal banking, business solutions, institutional banking, company information, and more",
  "tagline": "We are a team of 1000 people",
  "linkedin": "commbank",
  "employee_count": 1000,
  "year_founded": 2000,
  "hq_location": "Wallan",
  "hq_country": "Australia",
  "company_size": "1000+",
  "company_type": "Public company",
  "abn_operation_status": "active",
  "locations": [
    "Sydney",
    "Melbourne"
  ],
  "industries": [
    "Finance",
    "Tech"
  ],
  "revenue": ">$1B+",
  "phones": [
    "0450 600 0000"
  ],
  "emails": [
    "email@example.com"
  ],
  "social_media": {
    "twitter": "username",
    "youtube": "username",
    "facebook": "username",
    "linkedin": "username",
    "instagram": "username"
  },
  "industry_codes": {
    "sic": "1234567890",
    "duns": "1234567890",
    "naics": "1234567890",
    "anzsic": "1234567890",
    "abn": "47065475149",
    "acn": "123456789",
    "nzbn": "9429000000000",
    "uen": "202300001A"
  },
  "keywords": [
    "Finance",
    "Tech"
  ],
  "org_registers": {
    "vc": "VCs & Investors"
  },
  "states": [
    "NSW",
    "VIC"
  ],
  "nextGen": {
    "technographics": {
      "Software Development": [
        "PostgreSQL",
        "Java"
      ],
      "Finance & Accounting": [
        "Visa",
        "Pace"
      ]
    },
    "website": "https://www.example.com",
    "social_media": {
      "youtube": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "instagram": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "linkedin": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "facebook": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      }
    },
    "reviews_rating": {
      "ceo_approval": "4.5",
      "total_reviews": 100,
      "rating": {
        "ceo_approval_rating": "4.5",
        "career_opportunities_rating": "4.5",
        "compensation_and_benefits_rating": "4.5",
        "culture_and_values_rating": "4.5",
        "diversity_and_inclusion_rating": "4.5",
        "senior_management_rating": "4.5",
        "work_life_balance_rating": "4.5"
      },
      "overall_rating": "4.5",
      "employee_rating_id": "fp000000067890",
      "recommend_to_friend": 232,
      "url": 4.5
    },
    "id": "f0000067890",
    "web_traffic": {
      "summary": {
        "avg_visit_duration": "<string>",
        "total_web_visitors": 123,
        "bounce_rate": 123,
        "pages_per_visit": 123
      },
      "traffic_share": {
        "countries": {},
        "organic": 123,
        "paid": 123
      },
      "marketing_channels_distribution": {
        "Direct": 123,
        "Referrals": 123,
        "Search": 123,
        "Social": 123,
        "Mail": 123
      }
    }
  }
}

​
Description

Look up a company profile by Firmable ID, LinkedIn slug, LinkedIn URL, FQDN, ABN, or website. Use the optional country query param to return region-specific data. Supported country codes: AU, NZ, SG, MY, ID, PH, HK, JP, VN, KR, TH, US, CA. Defaults to AU when not provided. Returns a 400 error for unsupported country codes.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
id
string

The Firmable ID of the company (example: f000000117274)

​
ln_slug
string

The LinkedIn slug of the company (example: smec)

​
ln_url
string

LinkedIn URL of the company (example: https://www.linkedin.com/company/smec/)

​
fqdn
string

FQDN of the company (example: smec.com)

​
abn
string

ABN of the company (example: 47065475149)

​
website
string

Website of the company (example: https://www.smec.com)

​
country
enum<string>

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.

Available options:
AU,
NZ,
SG,
MY,
ID,
PH,
HK,
JP,
VN,
KR,
TH,
US,
CA

Response

Company response

​
id
string

The Firmable ID of the company.

Example:

"f0000067890"

​
name
string

The name of the company.

Example:

"The name of the company."

​
website
string

The company's website URL.

Example:

"https://www.example.com"

​
fqdn
string

The fully qualified domain name of the company's website.

Example:

"firmable.com"

​
description
string

A detailed description of the company.

Example:

"CommBank offers personal banking, business solutions, institutional banking, company information, and more"

​
tagline
string

A brief tagline or slogan for the company.

Example:

"We are a team of 1000 people"

​
linkedin
string

The company's LinkedIn handle.

Example:

"commbank"

​
employee_count
integer | null

The number of employees in the requested country region.

Example:

1000

​
year_founded
integer

The year the company was founded.

Example:

2000

​
hq_location
string | null

The headquarters location of the company.

Example:

"Wallan"

​
hq_country
string

The country of the company's headquarters.

Example:

"Australia"

​
company_size
string

The size category of the company.

Example:

"1000+"

​
company_type
string

The type of company (e.g., Private, Public).

Example:

"Public company"

​
abn_operation_status
string

The operational status of the company's ABN.

Example:

"active"

​
locations
string[]

The locations associated with the company.

Example:
["Sydney", "Melbourne"]
​
industries
string[]

The industries associated with the company.

Example:
["Finance", "Tech"]
​
revenue
string

The company's revenue, if available.

Example:

">$1B+"

​
phones
string[]

List of phone numbers associated with the company.

Example:
["0450 600 0000"]
​
emails
string[]

List of email addresses associated with the company.

Example:
["email@example.com"]
​
social_media
object

Social media profiles of the company.

​
industry_codes
object

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).

​
keywords
string[]

Keywords associated with the company.

Example:
["Finance", "Tech"]
​
org_registers
object

Information about organizational registers.

Example:
{ "vc": "VCs & Investors" }
​
states
string[]

Additional state information about the company.

Example:
["NSW", "VIC"]
​
nextGen
object

Next-generation data about the company.