1. Companies
FinancialReports
  • FinancialReports API Documentation
  • Changelog
  • Python SDK
  • S3 Bulk Delivery
  • Companies
    • List Companies
      GET
    • Retrieve Company Details
      GET
    • Retrieve Company Financials
      GET
    • Predict Next Annual Report
      GET
    • List Company Merges
      GET
    • Resolve Companies by Identifier (Batch)
      POST
  • Filings
    • List Filings
      GET
    • Retrieve Filing Details
      GET
    • Retrieve Filing History (Audit Trail)
      GET
    • Retrieve Filing Markdown
      GET
  • Filing Types
    • The Financial Reporting Classification Framework (FRCF)
    • List Filing Types
      GET
    • Retrieve Filing Type
      GET
  • Filing Categories
    • List Filing Categories
      GET
    • Retrieve Filing Category
      GET
  • Languages
    • Understanding Language Codes
    • List Languages
      GET
    • Retrieve Language
      GET
  • ISIC Classifications
    • Understanding ISIC Classification
    • List ISIC Classes
      GET
    • Retrieve ISIC Class
      GET
    • List ISIC Divisions
      GET
    • Retrieve ISIC Division
      GET
    • List ISIC Groups
      GET
    • Retrieve ISIC Group
      GET
    • List ISIC Sections
      GET
    • Retrieve ISIC Section
      GET
  • Countries
    • Understanding Country Codes
    • List Countries
    • Retrieve Country
  • Sources
    • Understanding Data Sources
    • List Data Sources
    • Retrieve Data Source
  • Watchlist
    • Get User's Watchlist
    • Add Company to Watchlist
    • Remove Company from Watchlist
    • Bulk Add Companies to Watchlist
    • Bulk Remove Companies from Watchlist
  • Webhooks (Management)
    • List Webhooks
    • Create Webhook
    • Retrieve Webhook
    • Update Webhook
    • Partial Update Webhook
    • Delete Webhook
    • List Delivery Logs
    • Retrieve Delivery Detail
    • Replay Delivery
    • Regenerate Secret Key
    • Test Webhook
    • Filing Processed Event
    • Filing Received Event
  • ISINs
    • List ISINs
    • Retrieve ISIN
  • Financial Data
    • List Line Item Definitions
    • Retrieve Line Item Definition
  • Security Listings
    • List security listings (exchange + ticker per company)
    • Retrieve a single security listing
  • Schemas
    • Company
    • Language
    • Filing
    • Source
    • BulkWatchlist
    • BulkWatchlistResponse
    • CompanyMinimal
    • Country
    • ErrorDetail
    • DesignatedSponsor
    • CompanyListing
    • FilingType
    • CompanyMerge
    • ISICClass
    • CompanyMergedInto
    • FilingProcessedPayload
    • ISICDivision
    • FilingCategory
    • ISICGroup
    • FilingHistory
    • CompanyResolveMatch
    • ISICSection
    • CompanyResolveRequest
    • EntityLegalForm
    • CompanyResolveResponse
    • CompanyResolveResult
    • PaginatedFilingTypeList
    • PaginatedCompanyMinimalList
    • CompanyResolveStatusEnum
    • CompanyResolveSummary
    • PaginatedCountryList
    • PaginatedISICClassList
    • CompanyResolveViaEnum
    • ISIN
    • ListedStockExchange
    • PaginatedISICDivisionList
    • PaginatedSourceList
    • PaginatedISICGroupList
    • PaginatedISICSectionList
    • FiscalPeriodEnum
    • NextAnnualReport
    • PaginatedLanguageList
    • PaginatedFilingCategoryList
    • WatchlistAction
    • Jurisdiction
    • WatchlistCompany
    • PaginatedFilingHistoryList
    • FilingSummary
    • WatchlistResponse
    • PaginatedWebhookList
    • PaginatedISINList
    • NullEnum
    • PaginatedWebhookDeliveryList
    • StockIndex
    • ProcessingStatusEnum
    • IngestionModeEnum
    • StatusEnum
    • LineItemDefinition
    • PaginatedCompanyMergeList
    • WebhookDelivery
    • WebhookSecret
    • PaginatedFilingSummaryList
    • PaginatedLineItemDefinitionList
    • StatementTypeEnum
    • PaginatedSecurityListingList
    • PatchedWebhook
    • ResolveRow
    • SecurityListing
    • WatchlistPage
    • Webhook
    • WebhookCompanyPayload
    • WebhookCreateResponse
    • WebhookDeliveryDetail
    • WebhookFilingPayload
    • WebhookReplayResponse
    • WebhookTestResponse
  1. Companies

List Company Merges

GET
/companies/merges/
Access Level Required: Requires Standard Access (Level 1).

Duplicate-company merges, oldest first.
When two records turn out to describe the same issuer we retire one and keep the other. The retired id disappears from the company list, so a warehouse built by incremental sync would otherwise keep the stale row forever. Poll this feed to reconcile.
Poll updated_at_from, not merged_at_from. Merges can be reversed, and a reversal edits the existing record in place rather than adding a new one — it moves updated_at but never merged_at. A reversed_at on a record you already ingested means the merge no longer holds and shell_id is a live company again.
Results are ordered by merged_at then id, so paging is stable even when a bulk merge writes several records in the same instant. Records are never deleted from this feed.
Covers merges recorded since 2026-06-29. Earlier cleanups predate this log and are not represented; companies removed by hard deletion rather than merge do not appear here either.

Request

Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.financialreports.eu/companies/merges/' \
--header 'x-api-key;' \
--header 'X-API-Key: <api-key>'

Responses

🟢200
application/json
Success.
Bodyapplication/json

Example
{
    "count": 123,
    "next": "http://api.example.org/accounts/?page=4",
    "previous": "http://api.example.org/accounts/?page=2",
    "results": [
        [
            {
                "id": 1126,
                "shell_id": 87192,
                "canonical_id": 75117,
                "shell_name": "Asian Phytoceuticals PCL (NVDR)",
                "canonical_name": "Asian Phytoceuticals PCL",
                "pattern": "exact_duplicate",
                "confidence": 0.96,
                "merged_at": "2026-06-29T03:33:28.806889+00:00",
                "reversed_at": null,
                "updated_at": "2026-06-29T03:33:28.806889+00:00"
            },
            {
                "id": 1204,
                "shell_id": 74554,
                "canonical_id": 10820,
                "shell_name": "Example Holdings Ltd",
                "canonical_name": "Example Holdings PLC",
                "pattern": "suffix_variant",
                "confidence": 0.88,
                "merged_at": "2026-06-29T05:12:04.113260+00:00",
                "reversed_at": "2026-07-18T06:21:50.824542+00:00",
                "updated_at": "2026-07-18T06:21:50.824542+00:00"
            }
        ]
    ]
}
🟠401
Modified at 2026-09-11 14:56:11
Previous
Predict Next Annual Report
Next
Resolve Companies by Identifier (Batch)
Built with