Skip to main content
POST
/
matching
/
text
/
match_external
Entity Name Resolution
curl --request POST \
  --url https://gateway.creditbenchmark.com/matching/text/match_external \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entities": [
    {
      "entity_name": "JPMorgan Chase & Co.",
      "industry": "Financials",
      "country": "United States"
    },
    {
      "entity_name": "Apple Inc.",
      "lei": "5493000X0X4X4X4X4X4X"
    }
  ],
  "limit": 3
}
'
{
  "results": [
    {
      "entity": "JPMorgan Chase & Co.",
      "candidates": [
        {
          "rank": 1,
          "CBId": "CB0000022706",
          "CBEntityName": "JPMORGAN CHASE & CO",
          "CBCountryOfRiskISO": "US",
          "isConsensus1M": true,
          "confidence": 0.82
        },
        {
          "rank": 2,
          "CBId": "CB0000118034",
          "CBEntityName": "JPMORGAN CHASE BANK NA",
          "CBCountryOfRiskISO": "US",
          "isConsensus1M": true,
          "confidence": 0.09
        }
      ]
    },
    {
      "entity": "Apple Inc.",
      "candidates": [
        {
          "rank": 1,
          "CBId": "CB0000000456",
          "CBEntityName": "APPLE INC",
          "CBCountryOfRiskISO": "US",
          "isConsensus1M": true,
          "confidence": 0.97
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

JWT bearer token.

Body

application/json
​
entities
object[]

Entities to match using the external route contract. Empty arrays are allowed and return results: [].

​
limit
integer
default:3

Maximum candidates to return per entity row. Valid integer values are 1 through 10. Omitted or out-of-range integers are normalized to 3; malformed non-integer values fail validation.

Response

Entity name resolution results

​
results
object[]
required

Table-style results keyed by input entity.