Endpoint
GETCompany
GET /company — returns company information by looking up a profile using any one of several identifiers.
Query parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Firmable company identifier (e.g. f000000117274) |
ln_slug | string | LinkedIn company slug (e.g. smec) |
ln_url | string | Full LinkedIn company URL |
fqdn | string | Fully-qualified domain name (e.g. smec.com) |
abn | string | Australian Business Number (e.g. 47065475149) |
website | string | Company website URL |
country | string | ISO country code for region-specific data |
Supported countries:
AU, NZ, SG, MY, ID, PH, HK, JP, VN, KR, TH, US, CA. Defaults to AU when omitted; an invalid code returns a 400.Example request
curl "https://api.firmable.com/company?abn=47065475149&country=AU" \
-H "Authorization: Bearer <FIRMABLE_API_KEY>"Responses
A success returns a Company object — core firmographics plus locations, industries, revenue, phones, emails, social_media, industry_codes (SIC, DUNS, NAICS, ANZSIC), and a nextGen object (technographics, web_traffic, reviews_rating).
200Company object
{
"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 }
}
}
}400Error
{
"error": 123,
"message": "<string>"
}