Company profile

Returns one company’s profile. It contains no financial values. Use Financial history for those.

Endpoint


GET https://api.vitati360.com/proxy/external/v1/company/{country}/{ticker}

Path parameter	Description
`country`	Country code, for example `qa`. Case-insensitive.
`ticker`	Ticker symbol, for example `qnbk`. Case-insensitive.

Response

Field	Type	Description
`ticker`	string	The ticker.
`name`	string	The company name.
`country`	string	The country code.
`region`	string	The region, for example `mena`.
`exchange`	string	The exchange the company is listed on.
`sector`	string or `null`	The sector.
`subsector`	string or `null`	The subsector.
`reportedCurrency`	string	The currency the company reports in.
`fiscalYearEnd`	string	The fiscal year end.

Examples

cURL


curl --compressed \
  -H "x-api-key: YOUR_API_KEY" \
  "https://api.vitati360.com/proxy/external/v1/company/qa/qnbk"

Python


import os
import requests
 
response = requests.get(
    "https://api.vitati360.com/proxy/external/v1/company/qa/qnbk",
    headers={"x-api-key": os.environ["VITATI_API_KEY"]},
    timeout=30,
)
response.raise_for_status()
profile = response.json()
 
print(profile["name"], profile["exchange"], profile["reportedCurrency"])

JavaScript


const response = await fetch(
  "https://api.vitati360.com/proxy/external/v1/company/qa/qnbk",
  { headers: { "x-api-key": process.env.VITATI_API_KEY } },
);
if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}
const profile = await response.json();
 
console.log(profile.name, profile.exchange, profile.reportedCurrency);

Errors

Status	When
`401`	The API key is missing, disabled, or expired.
`404`	No company matches the country and ticker.
`429`	The key has sent more requests than its limit in the current minute.

See Errors and rate limits.