FinancialReports API · API Reference

Filings

Endpoints for accessing company filings and their content.

GET /filings/

List Filings #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a paginated list of regulatory filings.

L1 · Standard Access Idempotent

Parameters

added_to_platform_from string · date-time optional

Filter by date added to platform (inclusive start date, YYYY-MM-DDTHH:MM:SSZ format).

added_to_platform_to string · date-time optional

Filter by date added to platform (inclusive end date, YYYY-MM-DDTHH:MM:SSZ format).

categories string optional

Filter by multiple Filing Category IDs. Comma-separated (e.g., 1,3).

category integer optional

Filter by a single Filing Category ID.

company integer optional

Filter by internal Company ID.

company_isin string optional

Filter by Company ISIN. Case-insensitive.

countries string optional

Filter by Company country ISO Alpha-2 code(s). Comma-separated for multiple values (e.g., US,GB,DE).

extensions string optional

Filter by file extension(s). Single (e.g., PDF) or comma-separated (e.g., PDF,XBRL). Case-insensitive.

file_size_max integer optional

Filter by maximum file size in bytes.

file_size_min integer optional

Filter by minimum file size in bytes.

fiscal_period string optional

Filter by fiscal period. Possible values: FY (Full Year), Q1, Q2, Q3, Q4, H1 (First Half), H2 (Second Half). Only populated for filing types: 10-K, 10-K-ESEF, IR, ER.

9MFYH1H2Q1Q2Q3Q4

fiscal_year integer optional

Filter by fiscal year (e.g., 2024). Only populated for filing types: 10-K, 10-K-ESEF, IR, ER.

language string optional

Filter by a single filing language ISO 639-1 code (e.g., en).

languages string optional

Filter by filing language ISO 639-1 code(s). Comma-separated for multiple values (e.g., en,de).

lei string optional

Filter by Company Legal Entity Identifier (LEI).

on_watchlist boolean optional

Filter by companies on the user's watchlist. Use 'true' to see only watchlist companies, 'false' to exclude them. Omitting the parameter returns all companies.

ordering string optional

Which field to use when ordering the results. Available fields: id, release_datetime, added_to_platform. Prefix with '-' for descending order (e.g., -release_datetime).

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

period_ending_date string optional

Filter by the exact period ending date (YYYY-MM-DD, e.g., 2024-12-31). Only populated for filing types: 10-K, 10-K-ESEF, IR, ER.

period_ending_date_from string optional

Filter by period ending date — inclusive start (YYYY-MM-DD).

period_ending_date_to string optional

Filter by period ending date — inclusive end (YYYY-MM-DD).

release_datetime_from string · date-time optional

Filter by release datetime (inclusive start, YYYY-MM-DDTHH:MM:SSZ format).

release_datetime_to string · date-time optional

Filter by release datetime (inclusive end, YYYY-MM-DDTHH:MM:SSZ format).

search string optional

Search across filing title and associated company name. Case-insensitive. Multiple whitespace-separated terms are AND-combined (each term must match either the title or the company name).

source number optional

Filter by a single data source ID.

sources string optional

Filter by data source ID(s). Comma-separated for multiple values (e.g., 38,40,51).

type string optional

Filter by Filing Type code (e.g., 10-K).

types string optional

Filter by multiple Filing Type codes. Comma-separated (e.g., 10-K,10-Q).

updated_date_from string · date-time optional

Filter by the date a filing was last updated on the platform (inclusive start, YYYY-MM-DDTHH:MM:SSZ format).

updated_date_to string · date-time optional

Filter by the date a filing was last updated on the platform (inclusive end, YYYY-MM-DDTHH:MM:SSZ format).

view string optional · default summary

Controls the level of detail. Omit for a default 'summary' view, or use 'full' to include all details for each filing.

fullsummary

Responses

200	OK
401	Unauthenticated

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/filings/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/filings/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/filings/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/filings/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "id": 32549034,
        "title": "Annual Report 2025 (ESEF ZIP)",
        "release_datetime": "2026-02-20T00:00:00+02:00",
        "processing_status": "COMPLETED",
        "file_extension": "ZIP",
        "file_size": 3303731,
        "document_url": "https://api.financialreports.eu/media/filings/SE/vnv-global/10-K-ESEF-2025.zip",
        "proxy_url": "https://financialreports.eu/filings/render/32549034/",
        "viewer_url": "https://financialreports.eu/filings/vnv-global-ab/annual-report-esef/2026/32549034/",
        "company": {
          "id": 882,
          "name": "VNV Global AB",
          "tagline": "Investment company with a focus on companies with network effects.",
          "isins": [
            "SE0014428835"
          ],
          "lei": "213800OFS5T6O6ZQQJ61",
          "sub_industry_code": "6420",
          "country_code": "SE"
        },
        "filing_type": {
          "id": 4,
          "code": "10-K-ESEF",
          "name": "Annual Report (ESEF)",
          "description": "European Single Electronic Format annual financial report."
        }
      }
    ]
  ]
}

GET /filings/{id}/

Retrieve Filing Details #

Access Level Required: Requires Standard Access (Level 1).

Retrieve detailed information for a single filing by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this filing.

Responses

200	OK
401	Unauthenticated
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/filings/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/filings/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/filings/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/filings/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 32549034,
  "company": {
    "id": 882,
    "name": "VNV Global AB",
    "isins": [
      "SE0014428835"
    ],
    "lei": "213800OFS5T6O6ZQQJ61",
    "sub_industry_code": "6420",
    "country_code": "SE"
  },
  "filing_type": {
    "id": 4,
    "code": "10-K-ESEF",
    "name": "Annual Report (ESEF)",
    "description": "European Single Electronic Format annual financial report."
  },
  "language": {
    "id": 1,
    "code": "en",
    "name": "English"
  },
  "filing_date": "2025-12-31",
  "title": "Annual Report 2025 (ESEF ZIP)",
  "added_to_platform": "2026-02-20T10:15:00Z",
  "updated_date": "2026-02-20T10:15:00Z",
  "dissemination_datetime": "2026-02-20T08:00:00Z",
  "release_datetime": "2026-02-20T00:00:00+02:00",
  "source": {
    "id": 1,
    "name": "Official Filing Authority — SE (#1)",
    "url": null,
    "description": "Official regulatory authority covering SE."
  },
  "document": "https://api.financialreports.eu/media/filings/SE/vnv-global/10-K-ESEF-2025.zip",
  "proxy_url": "https://financialreports.eu/filings/render/32549034/",
  "viewer_url": "https://financialreports.eu/filings/vnv-global-ab/annual-report-esef/2026/32549034/",
  "file_extension": "ZIP",
  "file_size": 3303731,
  "markdown_url": "https://api.financialreports.eu/api/filings/32549034/markdown/",
  "filing_type_confidence": 0.94,
  "filing_type_reasoning": "The document title contains 'Annual Report' and the filing period covers a full fiscal year (FY). The structure includes audited financial statements, a management discussion & analysis section, and a board report — all consistent with a 10-K-ESEF filing type. No quarterly indicators detected.",
  "fiscal_year": 2025,
  "fiscal_period": "FY",
  "period_ending_date": "2025-12-31"
}

GET /filings/{id}/history/

Retrieve Filing History (Audit Trail) #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a point-in-time audit trail of material changes made to this filing (e.g., classification or status updates).

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this filing.

Responses

200	OK
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/filings/{id}/history/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/filings/{id}/history/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/filings/{id}/history/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/filings/{id}/history/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

GET /filings/{id}/markdown/

Retrieve Filing Markdown #

Access Level Required: Requires Processed Filings (Level 2) access to view full converted content.

Retrieve the raw processed content of a single filing in Markdown format.

L2 · Processed Filings Idempotent

Parameters

id integer required · path

A unique integer value identifying this filing.

Responses

200	OK
403	Forbidden — tier or quota
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/filings/{id}/markdown/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/filings/{id}/markdown/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/filings/{id}/markdown/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/filings/{id}/markdown/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

"# ANNUAL REPORT 2023\n\n## OUR MISSION\n\nTO BE THE BEST SPORTS BRAND IN THE WORLD..."

Companies

Endpoints for querying company profiles and identifiers.

GET /companies/

List Companies #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a paginated list of companies.

L1 · Standard Access Idempotent

Parameters

countries string optional

Filter by Company country ISO Alpha-2 code(s). Comma-separated for multiple values.

industry string optional

Filter by ISIC Group code.

industry_group string optional

Filter by ISIC Division code.

isin string optional

Filter by Company ISIN. Case-insensitive.

lei string optional

Filter by Company Legal Entity Identifier (LEI). Case-insensitive.

on_watchlist boolean optional

Filter by companies on the user's watchlist. Use 'true' to see only watchlist companies, 'false' to exclude them. Omitting the parameter returns all companies.

ordering string optional

Which field to use when ordering the results. Available fields: id, name, date_ipo, year_founded, country_iso__name. Prefix with '-' for descending order (e.g., -name).

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

search string optional

Search across company name, LEI, ticker symbol, and associated ISIN codes. Case-insensitive. Multiple whitespace-separated terms are AND-combined (each term must match at least one of the searched fields).

sector string optional

Filter by ISIC Section code.

sub_industry string optional

Filter by ISIC Class code.

ticker string optional

Filter by Company primary stock Ticker symbol. Case-insensitive.

view string optional · default summary

Controls the level of detail. Omit for a default 'summary' view, or use 'full' to include all details for each company.

fullsummary

Responses

200	OK
401	Unauthenticated

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/companies/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/companies/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/companies/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/companies/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "id": 14,
        "name": "adidas AG",
        "tagline": "A leading global designer and marketer of athletic footwear, apparel, and accessories.",
        "isins": [
          "DE000A1EWWW0",
          "US00687A1079",
          "US00687P1049"
        ],
        "lei": "549300JSX0Z4CW0V5023",
        "sub_industry_code": "1410",
        "country_code": "DE"
      }
    ]
  ]
}

GET /companies/{id}/

Retrieve Company Details #

Access Level Required: Requires Standard Access (Level 1).

Retrieve detailed information for a single company by its internal ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this company.

Responses

200	OK
401	Unauthenticated
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/companies/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/companies/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/companies/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/companies/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 14,
  "name": "adidas AG",
  "tagline": "A leading global designer and marketer of athletic footwear, apparel, and accessories.",
  "description": "adidas is a global leader in the sporting goods industry. With the core brands adidas and Reebok, the company offers a broad portfolio of footwear, apparel and hardware for sport and lifestyle around the globe. Headquartered in Herzogenerauch, Germany, the company employs more than 61,000 people worldwide.",
  "description_last_updated": "2024-10-20T14:30:00Z",
  "isins": [
    "DE000A1EWWW0",
    "US00687A1079",
    "US00687P1049"
  ],
  "lei": "549300JSX0Z4CW0V5023",
  "country_code": "DE",
  "address": "Adi-Dassler-Straße 1",
  "city": "Herzogenerauch",
  "zip_code": "91074",
  "sector": {
    "code": "C",
    "name": "Manufacturing"
  },
  "industry_group": {
    "code": "14",
    "name": "Manufacture of wearing apparel",
    "sector": {
      "code": "C",
      "name": "Manufacturing"
    }
  },
  "industry": {
    "code": "141",
    "name": "Manufacture of wearing apparel, except fur apparel",
    "industry_group": {
      "code": "14",
      "name": "Manufacture of wearing apparel",
      "sector": {
        "code": "C",
        "name": "Manufacturing"
      }
    }
  },
  "sub_industry": {
    "code": "1410",
    "name": "Manufacture of wearing apparel, except fur apparel",
    "industry": {
      "code": "141",
      "name": "Manufacture of wearing apparel, except fur apparel",
      "industry_group": {
        "code": "14",
        "name": "Manufacture of wearing apparel",
        "sector": {
          "code": "C",
          "name": "Manufacturing"
        }
      }
    }
  },
  "ir_link": "https://www.adidas-group.com/en/investors/overview/",
  "homepage_link": "https://www.adidas-group.com/en/",
  "logo": "https://api.financialreports.eu/media/company_logos/adidas-logo.png",
  "date_public": "2025-08-09",
  "date_ipo": "1997-11-17",
  "main_stock_exchange": "XTRA",
  "is_listed": true,
  "social_facebook": null,
  "social_instagram": null,
  "social_twitter": "https://twitter.com/GamePlan_A",
  "social_linkedin": "https://www.linkedin.com/company/3748",
  "social_youtube": "https://www.youtube.com/@adidas",
  "social_tiktok": null,
  "social_pinterest": null,
  "social_xing": null,
  "social_glassdoor": null,
  "year_founded": "1949-05-09",
  "corporate_video_id": "6Ru_MuQ6VbQ",
  "served_area": "Worldwide",
  "headcount": 61400,
  "contact_email": "[email protected]",
  "ticker": "ADS",
  "local_company_id": "HRB 3868",
  "shares_outstanding": 178520000,
  "designated_sponsor": [
    {
      "id": 1,
      "name": "Deutsche Bank AG"
    },
    {
      "id": 2,
      "name": "Baader Bank AG"
    }
  ],
  "listed_stock_exchange": [
    {
      "id": 1,
      "name": "Frankfurt Stock Exchange (XETRA)",
      "ticker": "XETRA",
      "website": "https://www.xetra.com"
    }
  ],
  "stock_index": [
    {
      "id": 1,
      "name": "DAX",
      "ticker": "DAX",
      "isin": "DE0008469008"
    }
  ],
  "legal_status": "ACTIVE",
  "legal_form": {
    "elf_code": "XJHM",
    "name": "Aktiengesellschaft"
  },
  "jurisdiction": {
    "code": "DE",
    "name": "Germany"
  },
  "legal_address": "Adi-Dassler-Straße 1",
  "legal_city": "Herzogenaurach",
  "legal_zip_code": "91074"
}

GET /companies/{id}/financials/

Retrieve Company Financials #

Experimental endpoint — the response schema may change without an API version bump.

Returns standardized financial KPIs for a company as a structured document: a company envelope containing periods, each holding its Income Statement, Balance Sheet and Cash Flow statements, each holding line_items.

When several filings report the same period, the most recently published filing is selected; every contributing filing is listed in the statement's sources array. source_filing and sources are returned only for accounts with source unmasking enabled (sources_masked reports which applies). Use as_of=YYYY-MM-DD for a point-in-time view.

Use the depth and parent_code fields on each line item to render the Capital IQ-style statement hierarchy.

Access Level Required: Requires RAG / Agent (Level 3).

L3 · Financial KPIs Idempotent

Parameters

id integer required · path

A unique integer value identifying this company.

as_of string optional

Point-in-time query (YYYY-MM-DD). Returns the financials as they were known on that date — only filings released on or before as_of are considered when picking the statement for each period.

fiscal_period string optional

Filter by fiscal period.

9MFYH1H2Q1Q2Q3Q4

fiscal_year integer optional

Filter by exact fiscal year (e.g. 2024).

fiscal_year_from integer optional

Fiscal year range start (inclusive).

fiscal_year_to integer optional

Fiscal year range end (inclusive).

line_items string optional

Comma-separated KPI codes to include (e.g. revenue,ebitda,net_income_loss). Omit to return all extracted line items. Statements with none of the requested codes are dropped. Unknown codes return 400 — see /api/line-item-definitions/.

statement_type string optional

Filter to a single statement type.

BSCFSIS

Responses

200	OK
400	Bad Request
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/companies/{id}/financials/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/companies/{id}/financials/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/companies/{id}/financials/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/companies/{id}/financials/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "company_id": 100,
  "currency": {
    "code": "EUR",
    "name": "Euro",
    "symbol": "€"
  },
  "sources_masked": false,
  "filters": {
    "statement_type": null,
    "fiscal_year": null,
    "fiscal_year_from": null,
    "fiscal_year_to": null,
    "fiscal_period": null,
    "line_items": null,
    "as_of": null
  },
  "period_count": 1,
  "periods": [
    {
      "fiscal_year": 2024,
      "fiscal_period": "FY",
      "period_start_date": "2024-01-01",
      "period_end_date": "2024-12-31",
      "statements": [
        {
          "statement_type": "IS",
          "statement_type_display": "Income Statement",
          "currency": {
            "code": "EUR",
            "name": "Euro",
            "symbol": "€"
          },
          "source_filing": {
            "id": 32537845,
            "filing_type": "10-K",
            "release_datetime": "2025-03-15T10:00:00+00:00"
          },
          "extraction": {
            "model": "gemini-2.5-flash@2026-05-19",
            "prompt_version": "2026-05-19-v19-ebit-scale-cfs",
            "extracted_at": "2026-05-20T08:00:00+00:00",
            "notes": null
          },
          "sources": [
            {
              "filing_id": 32537845,
              "filing_type": "10-K",
              "release_datetime": "2025-03-15T10:00:00+00:00",
              "is_selected": true
            },
            {
              "filing_id": 31002211,
              "filing_type": "ESEF",
              "release_datetime": "2025-03-12T09:00:00+00:00",
              "is_selected": false
            }
          ],
          "line_items": [
            {
              "code": "revenue",
              "name": "Total Revenues",
              "statement_type": "IS",
              "depth": 0,
              "parent_code": null,
              "sort_order": 10,
              "value": "699767000.00",
              "raw_value": "699767.000000",
              "scale": "thousands",
              "currency": "EUR",
              "confidence": 0.98,
              "source_page": 42
            },
            {
              "code": "gross_profit",
              "name": "Gross Profit",
              "statement_type": "IS",
              "depth": 0,
              "parent_code": null,
              "sort_order": 40,
              "value": "571593000.00",
              "raw_value": "571593.000000",
              "scale": "thousands",
              "currency": "EUR",
              "confidence": 0.97,
              "source_page": 42
            }
          ]
        }
      ]
    }
  ]
}

GET /companies/{id}/next-annual-report/

Predict Next Annual Report #

Calculates the expected release window for the next annual report based on historical filing patterns.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this company.

Responses

200	OK
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/companies/{id}/next-annual-report/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/companies/{id}/next-annual-report/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/companies/{id}/next-annual-report/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/companies/{id}/next-annual-report/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "start_date": "2026-03-01",
  "end_date": "2026-03-10",
  "confidence": 85,
  "is_overdue": false
}

ISINs

Endpoints for resolving ISINs to Companies.

GET /isins/

List ISINs #

Access Level Required: Requires Standard Access (Level 1).

Search and resolve ISINs (International Securities Identification Numbers) to companies.

L1 · Standard Access Idempotent

Parameters

code string optional

—

codes string optional

Filter by multiple ISIN codes. Comma-separated (e.g., US1234567890,DE1234567890).

company integer optional

Filter by internal Company ID.

is_primary boolean optional

—

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

search string optional

Fuzzy search by ISIN code (e.g., 'US03').

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isins/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isins/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isins/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isins/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "code": "US0378331005",
        "is_primary": true,
        "company": {
          "id": 14,
          "name": "adidas AG",
          "tagline": "A leading global designer and marketer of athletic footwear, apparel, and accessories.",
          "isins": [
            "DE000A1EWWW0",
            "US00687A1079",
            "US00687P1049"
          ],
          "lei": "549300JSX0Z4CW0V5023",
          "sub_industry_code": "1410",
          "country_code": "DE"
        },
        "figi": "BBG000B9XRY4",
        "composite_figi": "BBG000B9Y5X2",
        "share_class_figi": "BBG001S5N8V8",
        "security_type": "Common Stock",
        "security_type2": "Common Stock",
        "market_sector": "Equity",
        "exch_code": "US",
        "figi_last_updated": "2026-03-15T08:30:00Z"
      }
    ]
  ]
}

GET /isins/{code}/

Retrieve ISIN #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific ISIN.

L1 · Standard Access Idempotent

Parameters

code string required · path

—

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isins/{code}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isins/{code}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isins/{code}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isins/{code}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "code": "US0378331005",
  "is_primary": true,
  "company": {
    "id": 14,
    "name": "adidas AG",
    "tagline": "A leading global designer and marketer of athletic footwear, apparel, and accessories.",
    "isins": [
      "DE000A1EWWW0",
      "US00687A1079",
      "US00687P1049"
    ],
    "lei": "549300JSX0Z4CW0V5023",
    "sub_industry_code": "1410",
    "country_code": "DE"
  },
  "figi": "BBG000B9XRY4",
  "composite_figi": "BBG000B9Y5X2",
  "share_class_figi": "BBG001S5N8V8",
  "security_type": "Common Stock",
  "security_type2": "Common Stock",
  "market_sector": "Equity",
  "exch_code": "US",
  "figi_last_updated": "2026-03-15T08:30:00Z"
}

Watchlist

Endpoints for managing your personal company watchlist.

GET /watchlist/

Get User's Watchlist #

Access Level Required: Requires Standard Access (Level 1).

Fetches all companies currently in the authenticated user's watchlist. Results are paginated.

L1 · Standard Access Idempotent

Responses

200	OK
401	Unauthenticated

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/watchlist/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/watchlist/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/watchlist/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/watchlist/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

[
  {
    "id": 14,
    "name": "adidas AG"
  },
  {
    "id": 6910,
    "name": "Mega Or Holdings Ltd."
  }
]

POST /watchlist/companies/

Add Company to Watchlist #

Access Level Required: Requires Standard Access (Level 1).

Adds a specified company to the authenticated user's watchlist.

L1 · Standard Access

Request body

company_id integer required

The unique identifier of the company to add or remove from the watchlist.

Example body

{
  "company_id": 14
}

Responses

201	Created
400	Bad Request
401	Unauthenticated
403	Forbidden — tier or quota

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/watchlist/companies/" \
  -X POST \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.post(
    "https://api.financialreports.eu/watchlist/companies/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/watchlist/companies/", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("POST", "https://api.financialreports.eu/watchlist/companies/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "status": "success",
  "message": "Company added to watchlist.",
  "company_id": 14
}

DELETE /watchlist/companies/{company_id}/

Remove Company from Watchlist #

Access Level Required: Requires Standard Access (Level 1).

Removes a specified company from the authenticated user's watchlist using the company_id from the URL path.

L1 · Standard Access

Parameters

company_id integer required · path

—

Responses

200	OK
401	Unauthenticated
403	Forbidden — tier or quota
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/watchlist/companies/{company_id}/" \
  -X DELETE \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.delete(
    "https://api.financialreports.eu/watchlist/companies/{company_id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/watchlist/companies/{company_id}/", {
  method: "DELETE",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("DELETE", "https://api.financialreports.eu/watchlist/companies/{company_id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "status": "success",
  "message": "Company removed from watchlist.",
  "company_id": 14
}

POST /watchlist/companies/bulk-add/

Bulk Add Companies to Watchlist #

Access Level Required: Requires Standard Access (Level 1).

Adds up to 100 companies to the authenticated user's watchlist in a single request. Companies already in the watchlist are silently skipped.

L1 · Standard Access

Request body

company_ids array<integer> required

A list of company IDs (1–100) to add or remove from the watchlist.

Example body

{
  "company_ids": [
    14,
    27,
    42
  ]
}

Responses

200	OK
400	Bad Request
401	Unauthenticated
403	Forbidden — tier or quota

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/watchlist/companies/bulk-add/" \
  -X POST \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.post(
    "https://api.financialreports.eu/watchlist/companies/bulk-add/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/watchlist/companies/bulk-add/", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("POST", "https://api.financialreports.eu/watchlist/companies/bulk-add/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "status": "success",
  "message": "3 companies added to watchlist.",
  "company_ids": [
    14,
    27,
    42
  ]
}

POST /watchlist/companies/bulk-remove/

Bulk Remove Companies from Watchlist #

Access Level Required: Requires Standard Access (Level 1).

Removes up to 100 companies from the authenticated user's watchlist in a single request. Companies not in the watchlist are silently skipped.

L1 · Standard Access

Request body

company_ids array<integer> required

A list of company IDs (1–100) to add or remove from the watchlist.

Example body

{
  "company_ids": [
    14,
    27
  ]
}

Responses

200	OK
400	Bad Request
401	Unauthenticated
403	Forbidden — tier or quota

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/watchlist/companies/bulk-remove/" \
  -X POST \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.post(
    "https://api.financialreports.eu/watchlist/companies/bulk-remove/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/watchlist/companies/bulk-remove/", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("POST", "https://api.financialreports.eu/watchlist/companies/bulk-remove/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "status": "success",
  "message": "2 companies removed from watchlist.",
  "company_ids": [
    14,
    27
  ]
}

ISIC Classifications

Endpoints for Browse the ISIC industrial classification system.

GET /isic-classes/

List ISIC Classes #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a paginated list of ISIC Classes.

L1 · Standard Access Idempotent

Parameters

code string optional

—

code__iexact string optional

—

code__in array<string> optional

Multiple values may be separated by commas.

industry_code string optional

Filter by parent ISIC Group code (e.g., 011)

industry_group_code string optional

Filter by grandparent ISIC Division code (e.g., 01)

name__icontains string optional

—

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

sector_code string optional

Filter by great-grandparent ISIC Section code (e.g., A)

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isic-classes/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isic-classes/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isic-classes/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isic-classes/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "code": "1410",
        "name": "Manufacture of wearing apparel, except fur apparel",
        "industry": {
          "code": "141",
          "name": "Manufacture of wearing apparel, except fur apparel",
          "industry_group": {
            "code": "14",
            "name": "Manufacture of wearing apparel",
            "sector": {
              "code": "C",
              "name": "Manufacturing"
            }
          }
        }
      }
    ]
  ]
}

GET /isic-classes/{id}/

Retrieve ISIC Class #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific ISIC Class by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this sub industry.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isic-classes/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isic-classes/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isic-classes/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isic-classes/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "code": "1410",
  "name": "Manufacture of wearing apparel, except fur apparel",
  "industry": {
    "code": "141",
    "name": "Manufacture of wearing apparel, except fur apparel",
    "industry_group": {
      "code": "14",
      "name": "Manufacture of wearing apparel",
      "sector": {
        "code": "C",
        "name": "Manufacturing"
      }
    }
  }
}

GET /isic-divisions/

List ISIC Divisions #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a paginated list of ISIC Divisions.

L1 · Standard Access Idempotent

Parameters

code string optional

—

code__iexact string optional

—

code__in array<string> optional

Multiple values may be separated by commas.

name__icontains string optional

—

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

sector_code string optional

Filter by parent ISIC Section code (e.g., A)

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isic-divisions/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isic-divisions/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isic-divisions/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isic-divisions/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "code": "14",
        "name": "Manufacture of wearing apparel",
        "sector": {
          "code": "C",
          "name": "Manufacturing"
        }
      }
    ]
  ]
}

GET /isic-divisions/{id}/

Retrieve ISIC Division #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific ISIC Division by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this industry group.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isic-divisions/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isic-divisions/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isic-divisions/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isic-divisions/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "code": "14",
  "name": "Manufacture of wearing apparel",
  "sector": {
    "code": "C",
    "name": "Manufacturing"
  }
}

GET /isic-groups/

List ISIC Groups #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a paginated list of ISIC Groups.

L1 · Standard Access Idempotent

Parameters

code string optional

—

code__iexact string optional

—

code__in array<string> optional

Multiple values may be separated by commas.

industry_group_code string optional

Filter by parent ISIC Division code (e.g., 01)

name__icontains string optional

—

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

sector_code string optional

Filter by grandparent ISIC Section code (e.g., A)

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isic-groups/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isic-groups/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isic-groups/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isic-groups/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "code": "141",
        "name": "Manufacture of wearing apparel, except fur apparel",
        "industry_group": {
          "code": "14",
          "name": "Manufacture of wearing apparel",
          "sector": {
            "code": "C",
            "name": "Manufacturing"
          }
        }
      }
    ]
  ]
}

GET /isic-groups/{id}/

Retrieve ISIC Group #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific ISIC Group by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this industry.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isic-groups/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isic-groups/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isic-groups/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isic-groups/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "code": "141",
  "name": "Manufacture of wearing apparel, except fur apparel",
  "industry_group": {
    "code": "14",
    "name": "Manufacture of wearing apparel",
    "sector": {
      "code": "C",
      "name": "Manufacturing"
    }
  }
}

GET /isic-sections/

List ISIC Sections #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a paginated list of ISIC Sections.

L1 · Standard Access Idempotent

Parameters

code string optional

—

code__iexact string optional

—

code__in array<string> optional

Multiple values may be separated by commas.

name__icontains string optional

—

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isic-sections/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isic-sections/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isic-sections/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isic-sections/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "code": "C",
        "name": "Manufacturing"
      }
    ]
  ]
}

GET /isic-sections/{id}/

Retrieve ISIC Section #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific ISIC Section by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this sector.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/isic-sections/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/isic-sections/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/isic-sections/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/isic-sections/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "code": "C",
  "name": "Manufacturing"
}

Filing Categories

Reference data for the 11 standardized disclosure types (FRCF).

GET /filing-categories/

List Filing Categories #

Access Level Required: Requires Standard Access (Level 1).

Retrieve the 11 standardized disclosure types (categories) defined by the FRCF.

L1 · Standard Access Idempotent

Parameters

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/filing-categories/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/filing-categories/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/filing-categories/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/filing-categories/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "id": 1,
        "name": "Financial Reporting & Information",
        "sort_order": 0
      }
    ]
  ]
}

GET /filing-categories/{id}/

Retrieve Filing Category #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific filing category by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this filing category.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/filing-categories/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/filing-categories/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/filing-categories/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/filing-categories/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 1,
  "name": "Financial Reporting & Information",
  "sort_order": 0
}

Filing Types

Reference data for all supported types of filings.

GET /filing-types/

List Filing Types #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a paginated list of all available filing types.

L1 · Standard Access Idempotent

Parameters

category integer optional

—

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

search string optional

A search term.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/filing-types/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/filing-types/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/filing-types/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/filing-types/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "id": 1,
        "code": "10-K",
        "name": "Annual Report",
        "description": "Official yearly report covering company activity and full financial performance.",
        "category": {
          "id": 1,
          "name": "Financial Reporting & Information",
          "sort_order": 0
        }
      }
    ]
  ]
}

GET /filing-types/{id}/

Retrieve Filing Type #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific filing type by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this filing type.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/filing-types/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/filing-types/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/filing-types/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/filing-types/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 1,
  "code": "10-K",
  "name": "Annual Report",
  "description": "Official yearly report covering company activity and full financial performance.",
  "category": {
    "id": 1,
    "name": "Financial Reporting & Information",
    "sort_order": 0
  }
}

Sources

Reference data for the original sources of filings.

GET /sources/

List Data Sources #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a paginated list of all available data sources.

L1 · Standard Access Idempotent

Parameters

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/sources/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/sources/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/sources/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/sources/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "id": 38,
        "name": "Official Filing Authority — DE (#38)",
        "url": null,
        "description": "Official regulatory authority covering DE."
      }
    ]
  ]
}

GET /sources/{id}/

Retrieve Data Source #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific data source by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this source.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/sources/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/sources/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/sources/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/sources/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 38,
  "name": "Official Filing Authority — DE (#38)",
  "url": null,
  "description": "Official regulatory authority covering DE."
}

Countries

Reference data for all supported countries.

GET /countries/

List Countries #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a list of all supported countries.

L1 · Standard Access Idempotent

Parameters

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/countries/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/countries/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/countries/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/countries/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "name": "Germany",
        "alpha_2": "DE",
        "alpha_3": "DEU",
        "numeric": "276"
      }
    ]
  ]
}

GET /countries/{id}/

Retrieve Country #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific country by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this country.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/countries/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/countries/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/countries/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/countries/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "name": "Germany",
  "alpha_2": "DE",
  "alpha_3": "DEU",
  "numeric": "276"
}

Languages

Reference data for all supported languages.

GET /languages/

List Languages #

Access Level Required: Requires Standard Access (Level 1).

Retrieve a list of all supported languages for filings.

L1 · Standard Access Idempotent

Parameters

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/languages/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/languages/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/languages/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/languages/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "code": "de",
        "name": "German"
      }
    ]
  ]
}

GET /languages/{id}/

Retrieve Language #

Access Level Required: Requires Standard Access (Level 1).

Retrieve details for a specific language by its ID.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this Language.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/languages/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/languages/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/languages/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/languages/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "code": "de",
  "name": "German"
}

Webhooks (Management)

Endpoints for creating, viewing, and managing your webhook subscriptions.

GET /webhooks/

List Webhooks #

Retrieve a list of all webhooks configured for your account. Note: Secret keys are not returned in this list.

L1 · Standard Access Idempotent

Parameters

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/webhooks/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/webhooks/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "id": 1,
        "url": "https://api.your-domain.com/webhook-receiver",
        "is_active": true,
        "include_markdown": false,
        "include_isins": false,
        "trigger_on_filing_received": false,
        "trigger_on_filing_processed": true,
        "track_all_companies": false,
        "subscribed_filing_types": [
          "10-K",
          "Annual Report"
        ],
        "created_at": "2025-11-15T10:30:00Z",
        "updated_at": "2025-11-15T10:30:00Z"
      }
    ]
  ]
}

POST /webhooks/

Create Webhook #

Create a new webhook subscription. The secret_key is returned in the response only once.

L1 · Standard Access

Request body

created_at string · date-time required

Timestamp when the webhook was created.

id integer required

The unique identifier for the webhook.

updated_at string · date-time required

Timestamp when the webhook was last updated.

url string · uri required

The endpoint URL (HTTPS required) to which the webhook payloads will be sent.

include_isins boolean optional

Set to 'true' to include the list of ISINs in the company object. Warning: Large companies may have thousands of ISINs, increasing payload size.

include_markdown boolean optional

Set to 'true' to include the full 'markdown_content' in the webhook payload. Set to 'false' to receive a payload without the markdown body.

is_active boolean optional

Set to 'false' to temporarily disable this webhook without deleting it.

subscribed_filing_types array<string> optional

A list of filing type codes (e.g., ['10-K', 'Annual Report']) to subscribe to. If this list is empty or omitted, you will be subscribed to all filing types.

track_all_companies boolean optional

Set to 'true' to subscribe to the Global Firehose. You will receive notifications for filings from ALL companies in the database, regardless of your Watchlist.

trigger_on_filing_processed boolean optional

If true, triggers when the filing has been fully analyzed and converted (Complete). Includes verified metadata and markdown content.

trigger_on_filing_received boolean optional

If true, triggers immediately when a filing is detected (Fastest). Note: Metadata like filing type may be null, and no markdown is included.

Example body

{
  "url": "https://api.your-domain.com/webhook-receiver",
  "is_active": true,
  "include_markdown": false,
  "include_isins": false,
  "trigger_on_filing_received": false,
  "trigger_on_filing_processed": true,
  "track_all_companies": false,
  "subscribed_filing_types": [
    "10-K",
    "Annual Report"
  ]
}

Responses

201

Created

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/" \
  -X POST \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.post(
    "https://api.financialreports.eu/webhooks/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("POST", "https://api.financialreports.eu/webhooks/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 1,
  "url": "https://api.your-domain.com/webhook-receiver",
  "is_active": true,
  "include_markdown": false,
  "include_isins": false,
  "trigger_on_filing_received": false,
  "trigger_on_filing_processed": true,
  "track_all_companies": false,
  "subscribed_filing_types": [
    "10-K",
    "Annual Report"
  ],
  "created_at": "2025-11-15T10:30:00Z",
  "updated_at": "2025-11-15T10:30:00Z",
  "secret_key": "whk_sec_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6"
}

GET /webhooks/{id}/

Retrieve Webhook #

Retrieve the details of a specific webhook by its ID. Note: Secret keys are not visible here.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this webhook.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/webhooks/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/webhooks/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 1,
  "url": "https://api.your-domain.com/webhook-receiver",
  "is_active": true,
  "include_markdown": false,
  "include_isins": false,
  "trigger_on_filing_received": false,
  "trigger_on_filing_processed": true,
  "track_all_companies": false,
  "subscribed_filing_types": [
    "10-K",
    "Annual Report"
  ],
  "created_at": "2025-11-15T10:30:00Z",
  "updated_at": "2025-11-15T10:30:00Z"
}

PUT /webhooks/{id}/

Update Webhook #

Update the details of a specific webhook.

L1 · Standard Access

Parameters

id integer required · path

A unique integer value identifying this webhook.

Request body

created_at string · date-time required

Timestamp when the webhook was created.

id integer required

The unique identifier for the webhook.

updated_at string · date-time required

Timestamp when the webhook was last updated.

url string · uri required

The endpoint URL (HTTPS required) to which the webhook payloads will be sent.

include_isins boolean optional

Set to 'true' to include the list of ISINs in the company object. Warning: Large companies may have thousands of ISINs, increasing payload size.

include_markdown boolean optional

Set to 'true' to include the full 'markdown_content' in the webhook payload. Set to 'false' to receive a payload without the markdown body.

is_active boolean optional

Set to 'false' to temporarily disable this webhook without deleting it.

subscribed_filing_types array<string> optional

A list of filing type codes (e.g., ['10-K', 'Annual Report']) to subscribe to. If this list is empty or omitted, you will be subscribed to all filing types.

track_all_companies boolean optional

Set to 'true' to subscribe to the Global Firehose. You will receive notifications for filings from ALL companies in the database, regardless of your Watchlist.

trigger_on_filing_processed boolean optional

If true, triggers when the filing has been fully analyzed and converted (Complete). Includes verified metadata and markdown content.

trigger_on_filing_received boolean optional

If true, triggers immediately when a filing is detected (Fastest). Note: Metadata like filing type may be null, and no markdown is included.

Example body

{
  "url": "https://api.your-domain.com/webhook-receiver",
  "is_active": true,
  "include_markdown": false,
  "include_isins": false,
  "trigger_on_filing_received": false,
  "trigger_on_filing_processed": true,
  "track_all_companies": false,
  "subscribed_filing_types": [
    "10-K",
    "Annual Report"
  ]
}

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/" \
  -X PUT \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.put(
    "https://api.financialreports.eu/webhooks/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/", {
  method: "PUT",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("PUT", "https://api.financialreports.eu/webhooks/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 1,
  "url": "https://api.your-domain.com/webhook-receiver",
  "is_active": true,
  "include_markdown": false,
  "include_isins": false,
  "trigger_on_filing_received": false,
  "trigger_on_filing_processed": true,
  "track_all_companies": false,
  "subscribed_filing_types": [
    "10-K",
    "Annual Report"
  ],
  "created_at": "2025-11-15T10:30:00Z",
  "updated_at": "2025-11-15T10:30:00Z"
}

PATCH /webhooks/{id}/

Partial Update Webhook #

Partially update the details of a specific webhook.

L1 · Standard Access

Parameters

id integer required · path

A unique integer value identifying this webhook.

Request body

created_at string · date-time optional

Timestamp when the webhook was created.

id integer optional

The unique identifier for the webhook.

include_isins boolean optional

Set to 'true' to include the list of ISINs in the company object. Warning: Large companies may have thousands of ISINs, increasing payload size.

include_markdown boolean optional

Set to 'true' to include the full 'markdown_content' in the webhook payload. Set to 'false' to receive a payload without the markdown body.

is_active boolean optional

Set to 'false' to temporarily disable this webhook without deleting it.

subscribed_filing_types array<string> optional

A list of filing type codes (e.g., ['10-K', 'Annual Report']) to subscribe to. If this list is empty or omitted, you will be subscribed to all filing types.

track_all_companies boolean optional

Set to 'true' to subscribe to the Global Firehose. You will receive notifications for filings from ALL companies in the database, regardless of your Watchlist.

trigger_on_filing_processed boolean optional

If true, triggers when the filing has been fully analyzed and converted (Complete). Includes verified metadata and markdown content.

trigger_on_filing_received boolean optional

If true, triggers immediately when a filing is detected (Fastest). Note: Metadata like filing type may be null, and no markdown is included.

updated_at string · date-time optional

Timestamp when the webhook was last updated.

url string · uri optional

The endpoint URL (HTTPS required) to which the webhook payloads will be sent.

Example body

{
  "is_active": false
}

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/" \
  -X PATCH \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.patch(
    "https://api.financialreports.eu/webhooks/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/", {
  method: "PATCH",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("PATCH", "https://api.financialreports.eu/webhooks/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "id": 1,
  "url": "https://api.your-domain.com/webhook-receiver",
  "is_active": true,
  "include_markdown": false,
  "include_isins": false,
  "trigger_on_filing_received": false,
  "trigger_on_filing_processed": true,
  "track_all_companies": false,
  "subscribed_filing_types": [
    "10-K",
    "Annual Report"
  ],
  "created_at": "2025-11-15T10:30:00Z",
  "updated_at": "2025-11-15T10:30:00Z"
}

DELETE /webhooks/{id}/

Delete Webhook #

Permanently delete a webhook subscription by its ID.

L1 · Standard Access

Parameters

id integer required · path

A unique integer value identifying this webhook.

Responses

204	No Content

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/" \
  -X DELETE \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.delete(
    "https://api.financialreports.eu/webhooks/{id}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/", {
  method: "DELETE",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("DELETE", "https://api.financialreports.eu/webhooks/{id}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

GET /webhooks/{id}/deliveries/

List Delivery Logs #

Retrieve a paginated list of delivery attempts (logs) for a specific webhook.

L1 · Standard Access Idempotent

Parameters

id integer required · path

A unique integer value identifying this webhook.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/deliveries/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/webhooks/{id}/deliveries/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/deliveries/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/webhooks/{id}/deliveries/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

GET /webhooks/{id}/deliveries/{delivery_uuid}/

Retrieve Delivery Detail #

Retrieve full details for a single delivery, including the reconstructed request payload and headers. The payload is rebuilt dynamically from the referenced filing record.

L1 · Standard Access Idempotent

Parameters

delivery_uuid string required · path

—

id integer required · path

A unique integer value identifying this webhook.

Responses

200	OK
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/deliveries/{delivery_uuid}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/webhooks/{id}/deliveries/{delivery_uuid}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/deliveries/{delivery_uuid}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/webhooks/{id}/deliveries/{delivery_uuid}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "webhook_id": 1,
  "event_type": "filing.processed",
  "filing_id": 12345,
  "status": "success",
  "response_status_code": 200,
  "duration_ms": 342,
  "created_at": "2025-11-15T10:30:00Z",
  "response_body": null,
  "request_headers": {
    "Content-Type": "application/json; charset=utf-8",
    "User-Agent": "FinancialReports-Webhook/2.0 (User: 1)",
    "X-Filing-Event": "filing.processed"
  },
  "request_payload": {
    "webhook_id": "1",
    "filing_id": "12345",
    "company": {
      "id": "100",
      "name": "Example Corp"
    },
    "filing": {
      "id": "12345",
      "title": "Annual Report 2024"
    },
    "triggered_at": "2025-11-15T10:30:00Z"
  }
}

POST /webhooks/{id}/deliveries/{delivery_uuid}/replay/

Replay Delivery #

Re-sends the webhook event for a specific delivery. A new delivery record is created with the result of the replay attempt.

L1 · Standard Access

Parameters

delivery_uuid string required · path

—

id integer required · path

A unique integer value identifying this webhook.

Request body

created_at string · date-time required

Timestamp when the webhook was created.

id integer required

The unique identifier for the webhook.

updated_at string · date-time required

Timestamp when the webhook was last updated.

url string · uri required

The endpoint URL (HTTPS required) to which the webhook payloads will be sent.

include_isins boolean optional

Set to 'true' to include the list of ISINs in the company object. Warning: Large companies may have thousands of ISINs, increasing payload size.

include_markdown boolean optional

Set to 'true' to include the full 'markdown_content' in the webhook payload. Set to 'false' to receive a payload without the markdown body.

is_active boolean optional

Set to 'false' to temporarily disable this webhook without deleting it.

subscribed_filing_types array<string> optional

A list of filing type codes (e.g., ['10-K', 'Annual Report']) to subscribe to. If this list is empty or omitted, you will be subscribed to all filing types.

track_all_companies boolean optional

Set to 'true' to subscribe to the Global Firehose. You will receive notifications for filings from ALL companies in the database, regardless of your Watchlist.

trigger_on_filing_processed boolean optional

If true, triggers when the filing has been fully analyzed and converted (Complete). Includes verified metadata and markdown content.

trigger_on_filing_received boolean optional

If true, triggers immediately when a filing is detected (Fastest). Note: Metadata like filing type may be null, and no markdown is included.

Responses

202	202
404	Not Found

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/deliveries/{delivery_uuid}/replay/" \
  -X POST \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.post(
    "https://api.financialreports.eu/webhooks/{id}/deliveries/{delivery_uuid}/replay/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/deliveries/{delivery_uuid}/replay/", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("POST", "https://api.financialreports.eu/webhooks/{id}/deliveries/{delivery_uuid}/replay/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "status": "success",
  "message": "Replay queued. A new delivery attempt will appear in the logs shortly."
}

POST /webhooks/{id}/regenerate-secret/

Regenerate Secret Key #

Generates a new, unique secret_key for this webhook. The old key will be invalidated immediately. This action is irreversible.

L1 · Standard Access

Parameters

id integer required · path

A unique integer value identifying this webhook.

Request body

created_at string · date-time required

Timestamp when the webhook was created.

id integer required

The unique identifier for the webhook.

updated_at string · date-time required

Timestamp when the webhook was last updated.

url string · uri required

The endpoint URL (HTTPS required) to which the webhook payloads will be sent.

include_isins boolean optional

Set to 'true' to include the list of ISINs in the company object. Warning: Large companies may have thousands of ISINs, increasing payload size.

include_markdown boolean optional

Set to 'true' to include the full 'markdown_content' in the webhook payload. Set to 'false' to receive a payload without the markdown body.

is_active boolean optional

Set to 'false' to temporarily disable this webhook without deleting it.

subscribed_filing_types array<string> optional

A list of filing type codes (e.g., ['10-K', 'Annual Report']) to subscribe to. If this list is empty or omitted, you will be subscribed to all filing types.

track_all_companies boolean optional

Set to 'true' to subscribe to the Global Firehose. You will receive notifications for filings from ALL companies in the database, regardless of your Watchlist.

trigger_on_filing_processed boolean optional

If true, triggers when the filing has been fully analyzed and converted (Complete). Includes verified metadata and markdown content.

trigger_on_filing_received boolean optional

If true, triggers immediately when a filing is detected (Fastest). Note: Metadata like filing type may be null, and no markdown is included.

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/regenerate-secret/" \
  -X POST \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.post(
    "https://api.financialreports.eu/webhooks/{id}/regenerate-secret/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/regenerate-secret/", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("POST", "https://api.financialreports.eu/webhooks/{id}/regenerate-secret/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "secret_key": "whk_sec_new_secret_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
}

POST /webhooks/{id}/test/

Test Webhook #

Sends a pre-defined 'filing.processed.test' event to the configured webhook URL to verify its functionality. This creates a delivery record.

L1 · Standard Access

Parameters

id integer required · path

A unique integer value identifying this webhook.

Request body

created_at string · date-time required

Timestamp when the webhook was created.

id integer required

The unique identifier for the webhook.

updated_at string · date-time required

Timestamp when the webhook was last updated.

url string · uri required

The endpoint URL (HTTPS required) to which the webhook payloads will be sent.

include_isins boolean optional

Set to 'true' to include the list of ISINs in the company object. Warning: Large companies may have thousands of ISINs, increasing payload size.

include_markdown boolean optional

Set to 'true' to include the full 'markdown_content' in the webhook payload. Set to 'false' to receive a payload without the markdown body.

is_active boolean optional

Set to 'false' to temporarily disable this webhook without deleting it.

subscribed_filing_types array<string> optional

A list of filing type codes (e.g., ['10-K', 'Annual Report']) to subscribe to. If this list is empty or omitted, you will be subscribed to all filing types.

track_all_companies boolean optional

Set to 'true' to subscribe to the Global Firehose. You will receive notifications for filings from ALL companies in the database, regardless of your Watchlist.

trigger_on_filing_processed boolean optional

If true, triggers when the filing has been fully analyzed and converted (Complete). Includes verified metadata and markdown content.

trigger_on_filing_received boolean optional

If true, triggers immediately when a filing is detected (Fastest). Note: Metadata like filing type may be null, and no markdown is included.

Responses

200	OK
400	Bad Request

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/webhooks/{id}/test/" \
  -X POST \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.post(
    "https://api.financialreports.eu/webhooks/{id}/test/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/webhooks/{id}/test/", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("POST", "https://api.financialreports.eu/webhooks/{id}/test/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "status": "success",
  "message": "Test event successfully sent. Endpoint responded with HTTP 200.",
  "delivery_uuid": "550e8400-e29b-41d4-a716-446655440000"
}

Financial Data

Endpoints for standardized financial KPIs (Income Statement, Balance Sheet, Cash Flow Statement) and the line item definition dictionary.

GET /line-item-definitions/

List Line Item Definitions #

Retrieve the full dictionary of standardized financial KPIs.

Each definition describes one line item that may appear in extracted financial statements (Income Statement, Balance Sheet, Cash Flow Statement). Use the depth and parent_code fields to reconstruct the Capital IQ-style hierarchy.

Access Level Required: Requires Standard Access (Level 1).

L1 · Standard Access Idempotent

Parameters

depth integer optional

Filter by hierarchy depth (0 = top-level, 1 = component, 2 = sub-component).

is_capital_iq_standard boolean optional

—

page integer optional

A page number within the paginated result set.

page_size integer optional

Number of results to return per page.

parent_code string optional

Filter by parent line item code (e.g. 'gross_profit' returns its children).

search string optional

A search term.

statement_type string optional

Filter by statement type (IS, BS, CFS, SUP).

IS - Income Statement
BS - Balance Sheet
CFS - Cash Flow Statement
SUP - Supplemental / Ratio

BSCFSISSUP

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/line-item-definitions/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/line-item-definitions/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/line-item-definitions/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/line-item-definitions/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    [
      {
        "code": "revenue",
        "name": "Total Revenue",
        "statement_type": "IS",
        "statement_type_display": "Income Statement",
        "depth": 0,
        "parent_code": null,
        "sort_order": 10,
        "category": "",
        "description": "",
        "aliases": [],
        "is_capital_iq_standard": true
      }
    ]
  ]
}

GET /line-item-definitions/{code}/

Retrieve Line Item Definition #

Retrieve a single line item definition by its code.

Access Level Required: Requires Standard Access (Level 1).

L1 · Standard Access Idempotent

Parameters

code string required · path

—

Responses

200

OK

Log in to try this endpoint live with your API key.

shell · cURL

curl "https://api.financialreports.eu/line-item-definitions/{code}/" \
  -X GET \
  -H "X-API-Key: $FR_API_KEY" \
  -H "Accept: application/json"

python · requests

import os, requests

response = requests.get(
    "https://api.financialreports.eu/line-item-definitions/{code}/",
    headers={
        "X-API-Key": os.environ["FR_API_KEY"],
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

node · fetch

const response = await fetch("https://api.financialreports.eu/line-item-definitions/{code}/", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.FR_API_KEY,
    "Accept": "application/json",
  },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

go · net/http

import (
    "net/http"
    "os"
)

req, _ := http.NewRequest("GET", "https://api.financialreports.eu/line-item-definitions/{code}/", nil)
req.Header.Set("X-API-Key", os.Getenv("FR_API_KEY"))
req.Header.Set("Accept", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil { return err }
defer resp.Body.Close()

Response · 200 OK

{
  "code": "revenue",
  "name": "Total Revenue",
  "statement_type": "IS",
  "statement_type_display": "Income Statement",
  "depth": 0,
  "parent_code": null,
  "sort_order": 10,
  "category": "",
  "description": "",
  "aliases": [],
  "is_capital_iq_standard": true
}