# Get company profile Who a company, security or fund is: names, description, sector, size, addresses and identifiers. ## How it works {#how-it-works} - **Look up an identifier.** Include the exchange if a ticker is ambiguous. For example, `TSCO:LN` identifies Tesco in London. - **A company name can match as a fallback.** A unique name match returns `match: "name_match"` and the selected ISIN in `matched_identifier`. - **`name` is in Latin script; `legal_name` is the name as registered.** For Hellenic Telecommunications, `name` is a Latin form and `legal_name` is its Greek registered name. Only when no source gives a Latin form does `name` keep the original script. - **Two countries, never mixed.** `domicile_country` is where the company is legally registered and `headquarters_country` is where it's run from. They differ for companies incorporated offshore. - **`primary_listing` identifies the main listing** when the evidence supports one. It's the same object as a venue in [Get securities and listings](https://financialdb.ai/documentation/api/listings.md), plus its security's `isin`, so code that reads one reads both. Funds with several trading lines can have a null primary. Every other venue is in Get securities and listings. - **If we can't tell which company you mean, you get a 404 saying so.** That covers identifiers that match nothing and ones that match several. The message says what to try, and the request is free. ## Request {#request} `GET /api/v1/profile` with your API key. AI assistants call it as the `get_profile` tool, with the same parameters. ``` curl "https://financialdb.ai/api/v1/profile?q=AAPL:US" \ -H "Authorization: Bearer $FDB_API_KEY" ``` ## Parameters {#parameters} | Parameter | Type | Description | |---|---|---| | `include_sources` | boolean | Include available source documents and supporting evidence. Omit for data only. Default: `false`. | | `q` (required) | string | Ticker with its exchange code or MIC (AAPL:US, AAPL:XNAS, TSCO:XLON), ISIN, CUSIP, SEDOL, WKN, FIGI, LEI, CIK or company registration number. Any ticker and mic a listing returns work as ticker:mic. A company name can match as a fallback. | ## Response {#response} JSON with these fields. A field the source doesn't report is null or left out. | Field | Description | |---|---| | `query` | The identifier or company name asked for | | `identifier_type` | Type of the requested identifier, null for a name match or ambiguous lookup | | `matched_identifier.type` | Identifier scheme selected by the name fallback | | `matched_identifier.value` | Identifier selected by the name fallback | | `profile.type` | Identity scope: legal_entity, fund, share_class, security or listing | | `profile.name` | Preferred display name, in Latin script whenever any source gives one. A company registered under a name in another script, such as Greek, gets a Latin form here; its registered name is legal_name | | `profile.short_name` | Short display name, in Latin script when any source gives one | | `profile.legal_name` | Reported legal name of the subject or identified issuer exactly as registered, which can be in its own language and script; not inferred from the display name | | `profile.cik` | Ten-digit SEC CIK of the subject or identified issuer | | `profile.phone` | Reported company contact telephone number | | `profile.legal_form` | Reported legal form of the entity | | `profile.description` | Business or investment-product description; a fund’s stated investment objective is labeled explicitly | | `profile.website` | Issuer, fund or fund-brand website | | `profile.security_type` | Instrument or fund type: common_stock, preferred_stock, depositary_receipt, reit, tracking_stock, stapled_security, unit, right, warrant, etf, etn, etc, etp, open_end_fund, closed_end_fund, private_equity_fund, investment_fund, derivative, other. The list can grow, so treat a value you don't recognise as other | | `profile.domicile_country` | Country where the entity, issuer or fund is legally registered, as an ISO 3166-1 alpha-2 code. Not its headquarters. | | `profile.headquarters_country` | Country the company is run from, as an ISO 3166-1 alpha-2 code. Can differ from domicile_country, for example for companies incorporated offshore. | | `profile.sector` | Business sector | | `profile.industry` | Business activity, such as Computer hardware or Food retail | | `profile.number_of_employees` | Reported workforce count from the last three years | | `profile.employees_as_of` | Date or period of the workforce count | | `profile.employees_basis` | What the count measures: headcount, full_time, full_time_equivalent or full_time_and_full_time_equivalent | | `profile.employees_estimated` | Whether the source published the count as an approximation | | `profile.employee_range` | Employee range, such as 200000-499999 | | `profile.founded_on` | Founding date of the business: YYYY, YYYY-MM or YYYY-MM-DD | | `profile.incorporated_on` | Incorporation date of the current legal entity | | `profile.first_traded_on` | First trading date for this ISIN at an admitting venue; may reflect a new ISIN or venue start, not the company's IPO | | `profile.public_float.value` | Reported market value of equity held by non-affiliates as a decimal string; not a share count or total market cap | | `profile.public_float.currency` | ISO 4217 currency code of the reported public-float value | | `profile.public_float.as_of` | Measurement date of the reported public-float value | | `profile.market_cap.value` | Reported market capitalisation as a decimal string, dated by as_of | | `profile.market_cap.currency` | ISO 4217 currency code | | `profile.market_cap.as_of` | Snapshot observation date, not a live quote timestamp | | `profile.shares_outstanding.value` | Reported shares outstanding for the issuer or stated share class. The count may cover a broader scope than the security identifier. Null when disclosures conflict. | | `profile.shares_outstanding.as_of` | Measurement date, or observation date for an exchange snapshot | | `profile.shares_outstanding.filing_date` | Publication date of the supporting filing, when available | | `profile.reporting_currency` | Currency shared by the latest available annual financial figures; null when mixed or unavailable | | `profile.reporting_currency_as_of` | Period end of the annual facts used for reporting_currency | | `profile.fiscal_year_end.month` | Month the fiscal year ends | | `profile.fiscal_year_end.day` | Day the fiscal year ends | | `profile.headquarters.line1` | First address line | | `profile.headquarters.line2` | Further address lines | | `profile.headquarters.city` | City | | `profile.headquarters.region` | Region or state code | | `profile.headquarters.postal_code` | Postal code | | `profile.headquarters.country` | ISO 3166-1 alpha-2 country code | | `profile.registered_address.line1` | First address line | | `profile.registered_address.line2` | Further address lines | | `profile.registered_address.city` | City | | `profile.registered_address.region` | Region or state code | | `profile.registered_address.postal_code` | Postal code | | `profile.registered_address.country` | ISO 3166-1 alpha-2 country code | | `profile.classifications[].scheme` | Scheme, such as SEC SIC, NACE Rev. 2 or ISO 10962 CFI | | `profile.classifications[].code` | Code in the scheme | | `profile.classifications[].name` | Name of the code | | `profile.entity_status` | Legal entity registration status: active or inactive. Does not establish whether a security is trading | | `profile.sec_filings_url` | SEC filing page for the identified company or issuer | | `profile.primary_listing.isin` | ISIN of the security this listing trades | | `profile.primary_listing.ticker` | Reported ticker for this trading line, which may use the source's symbol format | | `profile.primary_listing.exchange` | Exchange name | | `profile.primary_listing.mic` | Most specific ISO 10383 MIC of the trading line: a segment MIC (XNGS) or, off-segment, the operating MIC | | `profile.primary_listing.operating_mic` | ISO 10383 MIC of the exchange that runs the segment (XNAS for XNGS); equal to mic on the operating market itself | | `profile.primary_listing.country` | ISO 3166-1 alpha-2 country code of the exchange | | `profile.primary_listing.currency` | ISO 4217 currency of this listing, never a minor unit: a London line quoted in pence is GBP. Null when unavailable or conflicting | | `profile.primary_listing.figi` | FIGI of this trading line (venue level) | | `profile.primary_listing.composite_figi` | Country-level composite FIGI of this listing | | `profile.primary_listing.listed_on` | Reported listing date at this exchange, not necessarily the company's IPO date | | `profile.primary_listing.is_primary` | Whether it's the primary listing; null when the primary is unknown | | `profile.relationships[].relationship` | issued_by identifies the legal issuer or umbrella; share_class_of identifies the specific fund; managed_by and umbrella_managed_by distinguish direct and umbrella management; sibling-security inventories are omitted | | `profile.relationships[].type` | Identity scope of the related subject | | `profile.relationships[].name` | Name of the related company or fund | | `profile.relationships[].website` | Manager website, when supplied for a managed_by or umbrella_managed_by relationship | | `match` | Identifier lookup outcome. A found match can still have an empty page. | ## Errors {#errors} | Status | Meaning | |---|---| | 400 | Missing, unknown or invalid parameter, or an identifier that can't be looked up | | 401 | Missing, unknown or revoked API key | | 402 | No active plan or trial, or the included request allowance is used | | 403 | API access of the account is suspended | | 404 | The identifier matches nothing or is ambiguous. The match field identifies the outcome | | 429 | Over the plan's rate limit; Retry-After says when to retry | | 500 | Internal error; the same request is unlikely to succeed on retry | | 503 | The data couldn't be loaded right now; Retry-After says when to retry, when known | Errors are JSON with an `error` message saying what to fix. Errors are free. See [Errors and limits](https://financialdb.ai/documentation/api/errors-and-limits.md).