API · Companies
Get company profile
Narrative business context — what the company does, customers, geography, strategy, risks.
GET/api/v1/data/companies/{company}/profile
Returns Clarifo's analytical profile: a structured narrative covering overview, products & services, customers, geography, strategy, risks (with materiality classifications), and critical accounting policies.
The profile is LLM-generated from filings — it is qualitative analysis,
not raw filing text. The response field
source = "clarifo_analytical_profile" makes this explicit so you can
distinguish analytical content from filing-grade data.
When to use this
- Generating a one-paragraph company description for a UI.
- Giving an LLM enough business context before it reasons over the numbers.
- Surfacing a quick "what does this company actually do?" tooltip.
For audit-grade citations, pair with content search and the snapshot endpoint.
Path
| Field | Type | Description |
|---|---|---|
| companyrequired | string | Name or ticker. Fuzzy matching is supported. |
Query
| Field | Type | Description |
|---|---|---|
| locale | string default: en | en | fi. Falls back to the other locale if requested one is empty. |
| include_full_text | boolean default: false | false = short previews (smaller token footprint); true = full multi-paragraph narrative. |
Example
bash
curl "https://api.clarifo.com/api/v1/data/companies/Fiskars/profile?locale=en" \
-H "Authorization: Bearer $CLARIFO_API_KEY"Response
json
{
"company_name": "Fiskars Oyj Abp",
"locale": "en",
"source": "clarifo_analytical_profile",
"updated_at": "2026-04-01T12:00:00Z",
"overview": "Fiskars Group is a Finnish consumer goods company …",
"products_services": {"text": "…", "tags": ["consumer goods", "premium"]},
"customers": {"text": "…", "tags": [ … ]},
"geography": {"text": "…", "tags": [ … ]},
"strategy": "…",
"risks": {"text": "…", "tags": [ … ]},
"accounting": {"text": "…", "tags": [ … ]}
}