Skip to Content
Getting started

Getting started

This page takes you from an API key to your first response.

1. Get an API key

API keys are issued by the Vitati360 team. Ask your account contact for a key, and tell them which company and data you need.

Each key has its own request limit per minute, set when it is issued. A key can also have an expiry date, and the team can disable a key. See Errors and rate limits.

Keep the key secret. Anyone with it can use your limit. Call the API from your server, not from browser code, so the key is never visible to visitors. If you think a key has leaked, ask the team to rotate it.

2. Make a request

Send the key in the x-api-key header:

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.vitati360.com/proxy/external/v1/company/qa/qnbk/financials?period=annual"

Replace YOUR_API_KEY with your key. The path takes a country code and a ticker, both lowercase. The period query parameter is optional and defaults to all.

3. Read the response

The response is JSON. It starts with the company, its reporting currency, and then the annual or quarterly reports:

{
  "company": { "ticker": "qnbk", "name": "Qatar National Bank", "country": "qa", "region": "mena" },
  "reportedCurrency": "QAR",
  "annualReports": [
    { "fiscalYear": 2025, "fiscalPeriod": "FY", "periodEnd": "2025-12-31", "filedAt": "2026-02-10" }
  ]
}

The full shape, with every statement, is in the API reference.

Next steps

IntroductionErrors and rate limits