Companies

Resolve Companies by Identifier (Batch)

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


Reconcile a list of your identifiers against our coverage in one request.

Each row may carry any mix of isin, lei, cik, ticker and name, plus an optional opaque ref echoed back so you can join results to your source rows. Results are returned in input order.

Resolution order — ISIN, LEI, CIK, ticker, venue ticker, name. First hit wins, but every identifier you supply is evaluated: if two of them resolve to different companies the row comes back ambiguous with identifier_conflict and both in candidates, rather than us silently picking one.

A name alone never returns matched. No matter how close the match, a name-only row caps at ambiguous and hands you candidates to choose from. Names are not identifiers, and asserting a match on one is how filings end up attached to the wrong issuer.

Venue-ticker matches are qualified, not asserted. A ticker that only resolves through our security-listing data is cross-checked against the name you supplied. If they disagree you get ambiguous + name_disagrees; if you supplied no name we cannot corroborate at all, so you get matched carrying security_listing_unverified — trust that bucket accordingly.

A ticker is checked against your name, even on a single hit. Tickers are reused across exchanges: if your name rules out the company holding the ticker as its primary one and backs a company holding it on another venue, that company is the match. When other companies hold the same ticker on other venues and nothing you sent rules them out, the row carries multiple_tickers and lists them in candidates, even on a matched row. Append an ISO country code (WDI.DE) to pin the exchange.

Billing — one request is one call against your quota, whatever the row count. Rows we do not cover are not billed differently from rows we do.

Maximum 500 rows per request. Up to 50 rows per request reach the name lookup, within 25 seconds; beyond either a row carrying only a name returns not_covered with name_tier_skipped, so split large name-heavy batches.

post/companies/resolve/

Request

  • Base URL: https://api.financialreports.eu
  • URL: https://api.financialreports.eu/companies/resolve/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

Response

Reconciliation complete. Individual rows may still be unmatched.

Changes

No recorded changes to this operation across all 2 revisions of this API.