# QNB — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access QNB's financial statements, quarterly and annual reports, investor presentations, and earnings call transcripts to analyze comprehensive financial data and ratios. Track share information, regulatory announcements, and financial calendars to stay informed on QNB's investor relations updates and market performance.

**Category:** Finance & Markets | **Website:** [qnb.com/](https://qnb.com/) | **Docs:** [parse.bot/marketplace/d63bba88-d97a-417c-bff6-d7ff66d23827/qnb-com-api](https://parse.bot/marketplace/d63bba88-d97a-417c-bff6-d7ff66d23827/qnb-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_12_quarter_summary

Aggregates quarterly income statement financial data and calculates quarter-over-quarter percentage changes for key metrics (Net Interest Income, Operating Income, Profit for the Period, Profit for the Year). Returns all available quarters with QoQ% change fields appended to each period object.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_12_quarter_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_annual_reports_listing

Returns all available annual reports from QNB investor relations, spanning from 1966 to the most recent year. Each document includes title, PDF URL, and extracted year.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_annual_reports_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_financial_calendar

Retrieves financial calendar events from the QNB Euroland calendar API. Returns upcoming and recent events with dates and highlight status. May return an empty array when no events are currently scheduled.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_financial_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_financial_data

Extracts structured financial data from the Euroland Interactive Analysis tool for QNB. Returns a table of periods with metric values. Metrics vary by statement_type: income returns revenue/profit metrics, balance returns asset/liability metrics, ratios returns financial ratios, segments returns business segment breakdowns.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period_type` | string | No | Period granularity for the data. |
| `statement_type` | string | No | Financial statement category to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_financial_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period_type":"<string>","statement_type":"<string>"}'
```

### get_investor_presentations

Lists all available investor presentation documents from QNB investor relations. Returns titles and PDF URLs ordered newest first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_investor_presentations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_ir_call_transcripts

Lists all available IR call transcript documents from QNB investor relations. Returns titles and PDF URLs ordered newest first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_ir_call_transcripts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_quarterly_results_listing

Returns all available quarterly financial result documents from QNB investor relations. Each document includes title, PDF URL, extracted year, and quarter identifier. Documents are ordered as they appear on the page (newest first).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_quarterly_results_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_regulatory_announcements

Lists regulatory announcements and QSE disclosures with titles and document URLs from the QNB investor relations page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_regulatory_announcements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_share_information

Retrieves current share information and market data for QNB (QNBK on Qatar Exchange) including last price, volume, market cap, 52-week range, and YTD performance from the Euroland share series tool. Data is real-time during trading hours.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qnb-com-api-d63bba88/get_share_information \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```