# Orlen — 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.

> Retrieve comprehensive information about ORLEN S.A., including company details, contact information, office locations, current wholesale fuel prices, available fuel products, investor reports, and dividend data. Access corporate and financial insights directly to support business decisions, market research, or investor analysis.

**Category:** Finance & Markets | **Website:** [orlen.pl/](https://orlen.pl/) | **Docs:** [parse.bot/marketplace/cd64010a-f743-4190-9731-0891ebfa39ed/orlen-pl-api](https://parse.bot/marketplace/cd64010a-f743-4190-9731-0891ebfa39ed/orlen-pl-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-orlen-pl-api-cd64010a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company_info

Extract core ORLEN company information including name, description, headquarters address, and social media links. Returns a single record with static company metadata scraped from the ORLEN homepage.

**Estimated cost:** Metered

_No parameters required._

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

### get_contact_details

Retrieve contact details such as email addresses and phone numbers extracted from the ORLEN homepage and contact page. Scans footer and contact sections for mailto/tel links and regex-matched patterns.

**Estimated cost:** Metered

_No parameters required._

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

### get_dividend_info

Extract dividend history and information from the ORLEN investor relations dividend page. Returns tabular data with year, dividend per share, total dividend, record date, and payment date.

**Estimated cost:** Metered

_No parameters required._

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

### get_fuel_products

Retrieve fuel product definitions from the ORLEN product catalog, including product IDs, Polish and English names, and symbols. These symbols correspond to productName values in wholesale price data.

**Estimated cost:** Metered

_No parameters required._

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

### get_investor_reports_current

Retrieve current stock exchange reports (raporty bieżące) from the ORLEN investor relations page. Returns report numbers, dates, and titles for regulatory filings.

**Estimated cost:** Metered

_No parameters required._

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

### get_office_locations

Extract office location details including office names, addresses, and phone numbers from the ORLEN office locations page. Parses the accordion UI component listing each regional office.

**Estimated cost:** Metered

_No parameters required._

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

### get_wholesale_fuel_prices

Retrieve current wholesale fuel prices from the ORLEN pricing API. Returns prices in PLN per 1000 liters with effective dates. Updated daily when markets are open.

**Estimated cost:** Metered

_No parameters required._

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