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.

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; beyond that a row carrying only a name returns not_covered with name_tier_skipped, so split large name-heavy batches.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Example

{
    "rows": [
        {
            "ref": "sheet-row-12",
            "ticker": "GOOG",
            "name": "Alphabet Inc."
        },
        {
            "ref": "sheet-row-13",
            "isin": "US5949181045"
        },
        {
            "ref": "sheet-row-14",
            "cik": 320193
        },
        {
            "ref": "sheet-row-15",
            "name": "A Company We Do Not Cover Ltd"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Reconciliation complete. Individual rows may still be unmatched.

Bodyapplication/json

Example

{
    "summary": {
        "matched": 3,
        "matched_via_alias": 0,
        "ambiguous": 0,
        "not_covered": 1
    },
    "results": [
        {
            "ref": "sheet-row-12",
            "input": {
                "ticker": "GOOG",
                "name": "Alphabet Inc."
            },
            "status": "matched",
            "resolved_via": "security_listing",
            "company": {
                "id": 1234,
                "name": "Alphabet Inc.",
                "ticker": "GOOGL",
                "isins": [
                    "US02079K3059"
                ],
                "lei": "5493006MHB84DD0ZWV18",
                "country_code": "US",
                "listing_status": "LISTED"
            },
            "candidates": [],
            "warnings": []
        },
        {
            "ref": "sheet-row-13",
            "input": {
                "isin": "US5949181045"
            },
            "status": "matched",
            "resolved_via": "isin",
            "company": {
                "id": 5678,
                "name": "Microsoft Corporation",
                "ticker": "MSFT",
                "isins": [
                    "US5949181045"
                ],
                "lei": "INR2EJN1ERAN0W5ZP974",
                "country_code": "US",
                "listing_status": "LISTED"
            },
            "candidates": [],
            "warnings": []
        },
        {
            "ref": "sheet-row-14",
            "input": {
                "cik": 320193
            },
            "status": "matched",
            "resolved_via": "cik",
            "company": {
                "id": 9012,
                "name": "Apple Inc.",
                "ticker": "AAPL",
                "isins": [
                    "US0378331005"
                ],
                "lei": "HWUPKR0MPOU8FGXBT394",
                "country_code": "US",
                "listing_status": "LISTED"
            },
            "candidates": [],
            "warnings": []
        },
        {
            "ref": "sheet-row-15",
            "input": {
                "name": "A Company We Do Not Cover Ltd"
            },
            "status": "not_covered",
            "resolved_via": null,
            "company": null,
            "candidates": [],
            "warnings": []
        }
    ]
}

🟠400

🟠401

🟠403