Company profile

Query basic profile data for a public company.

GET/api/v1/fundamentals/profile
Domain
Fundamentals
Level
Public-company entity
MCP tool
fundamentals_query (task=profile)

Available data

Returns
Basic profile data for a public company
Market coverage
US and Hong Kong equities
Query granularity
One company per query

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Company positioning

Provide query, symbol, or ticker when possible; an empty request returns no_data.

querystringqueryExampleAAPLoptional

Search text used to identify the object you want.

symbolstringqueryExampleAAPLoptional

Company symbol; compatibility alias of query.

tickerstringqueryExampleAAPLoptional

Company ticker.

Query options

All optional.

marketMarketqueryExampleus_equityoptional

us_equity | hk_equity | kr_equity | uk_equity | jp_equity | crypto

limitintegerqueryExample20optional

Max rows to return (up to 1000).

Response

dataobject
profileobject

Company profile: company_name, description, management, profile_items, …

entity_idstringExampleentity_sec_cik_0000320193

Company entity id

company_namestringExample苹果

Company name

descriptionstring | nullExample苹果公司从事智能手机、个人电脑、平板电脑、可穿戴设备和配件的设计、制造和销售,以…

Company description

websitestring | nullExamplehttp://www.apple.com

Company website

industrystring | null

Industry

sectorstring | null

Sector

business_scopestring | null

Business scope

headquarters_countrystring | nullExampleUS

Headquarters country

reporting_currencystring | null

Reporting currency

employee_countnumber | nullExample166000

Employee count

profile_as_ofstring | nullExample2026-07-22T18:37:17.000+0000

Profile as-of date

data_statusDataStatusExamplepartial

Profile readiness

empty_reasonstring | nullExampleprofile_classification_incomplete

Profile empty reason

management[]object[]

Management roster

management_namestringExampleMr. Timothy D. Cook

Name

management_positionstringExampleCEO

Position

profile_items[]object[]

Extra profile key/value items

profile_keystringExamplefounded_date

Profile key

profile_namestringExample成立日期

Profile display name

profile_valuestringExample1976

Profile value

field_typestringExample0

Field type

empty_fields[]object[]

Missing fields with empty_reason (when partial)

fieldstringExamplesector

Missing field name

empty_reasonstringExampleprofile_classification_missing

Empty-reason code

data_statusDataStatusExamplepartial

ok / partial / no_data / not_ready / stale

empty_reasonstring | nullExampleprofile_classification_incomplete

Empty / partial reason code when applicable

errorobject | null

Error object (code / message); null on success

metadataobject
actual_taskstringExampleprofile

Routed task: profile / statements / metrics / …

data_statusDataStatusExamplepartial

ok / partial / no_data / not_ready / stale

limitations[]string[]Exampleserving_mvp

Coverage / MVP limitation tags

route_reasonstringExampleexplicit_task

Route reason (e.g. explicit_task)

updated_atdatetime | stringExample2026-08-17T08:24:43Z

Envelope update time (UTC)

partialbooleanExampletrue

True when the payload is intentionally incomplete

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleentity

Object reference type

idstringExampleentity_sec_cik_0000320193

Canonical object identifier

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

listing_idstringExamplelisting_aapl_xnas

Canonical listing identifier

instrument_idstringExampleinstrument_aapl_common_stock

Canonical financial instrument identifier

venue_idstringExamplevenue_xnas

Canonical trading venue identifier

external_refs[]object[]

External refs (e.g. SEC EDGAR filings)

lineage_refs[]object[]

Lineage refs (usually [] on the public body)

source_refs[]object[]

Upstream source refs (usually [] on the public body)

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.