Credit Benchmark Entity Matching API
Entity name matching and identification
Entity name matching and identification
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/creditbenchmark-entity-matching-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Credit Benchmark Entity Matching API
description: 'Authentication, matching, and analytics.
'
version: 1.0.0
contact:
name: Credit Benchmark API Support
email: api-support@creditbenchmark.com
url: https://creditbenchmark.com/support
license:
name: Proprietary
url: https://creditbenchmark.com/terms
servers:
- url: https://api.creditbenchmark.com
description: Production server
security:
- BearerAuth: []
tags:
- name: Entity Matching
description: Entity name matching and identification
paths:
/matching/match:
post:
tags:
- Entity Matching
summary: Entity Name Matching
description: 'Return ranked entity matches.
'
operationId: matchEntities
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MatchBody'
example:
queries:
- text: JPMorgan Chase & Co.
industry: Financials
country_name: United States
- text: Apple Inc.
lei: 5493000X0X4X4X4X4X4X
responses:
'200':
description: Entity matching completed successfully
content:
application/json:
schema:
$ref: '#/components/schemas/MatchExternalResponse'
example:
results:
- entity: JPMorgan Chase
candidates:
- rank: 1
CBId: CB0000022706
CBEntityName: JPMORGAN CHASE & CO
CBCountryOfRiskISO: US
isConsensus1M: true
confidence: 0.82
- rank: 2
CBId: CB0000118034
CBEntityName: JJPMORGAN 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
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'422':
$ref: '#/components/responses/ValidationError'
'500':
$ref: '#/components/responses/InternalServerError'
components:
responses:
Forbidden:
description: Forbidden - insufficient permissions or access denied
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: PERMISSION_DENIED
message: Insufficient permissions for this resource
InternalServerError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INTERNAL_SERVER_ERROR
message: An unexpected error occurred.
BadRequest:
description: Bad request - invalid parameters
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: BAD_REQUEST
message: Invalid request parameters
details:
invalid_columns:
- BadColumn
allowed_columns: Please check documentation for valid column names
Unauthorized:
description: Unauthorized - invalid or missing JWT token
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: Invalid or missing JWT token
ValidationError:
description: Validation error - request parameters are invalid
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: VALIDATION_ERROR
message: Request validation failed
details:
- field: body.Parameters.portfolio
message: field required
type: value_error.missing
schemas:
Query:
type: object
description: A single entity name query for matching
required:
- text
properties:
text:
type: string
description: The company name to match
example: JPMorgan Chase & Co.
industry:
type: string
description: Optional industry filter to improve matching accuracy
example: Financials
lei:
type: string
description: Optional Legal Entity Identifier (LEI) for exact matching
example: 5493000X0X4X4X4X4X4X
country_name:
type: string
description: Optional country name or code to filter matches
example: United States
ExternalCandidate:
type: object
description: A ranked candidate match for an entity query
required:
- rank
- CBId
- CBEntityName
- confidence
properties:
rank:
type: integer
description: 1-based rank of the candidate (1 = best match)
minimum: 1
example: 1
CBId:
type: string
description: Credit Benchmark entity identifier
example: CB0000000121
CBEntityName:
type: string
description: Credit Benchmark entity name
example: JPMorgan Chase & Co.
CBCountryOfRiskISO:
type: string
description: ISO 3166-1 alpha-2 country code
example: US
isConsensus1M:
type: boolean
description: Whether the entity has a 1-month consensus rating
example: true
confidence:
type: number
format: float
description: Confidence score for the match (0.0 to 1.0)
minimum: 0
maximum: 1
example: 0.98
MatchExternalResponse:
type: object
description: Response containing entity matching results
required:
- results
properties:
results:
type: array
items:
$ref: '#/components/schemas/ExternalMatchRow'
description: Table-style results keyed by input entity
default: []
ExternalMatchRow:
type: object
description: Matching results for a single entity query
required:
- entity
- candidates
properties:
entity:
type: string
description: Original query text
example: JPMorgan Chase & Co.
candidates:
type: array
items:
$ref: '#/components/schemas/ExternalCandidate'
description: Ordered list of candidate matches, sorted by rank
default: []
MatchBody:
type: object
description: Request body for entity name matching
required:
- queries
properties:
queries:
type: array
items:
$ref: '#/components/schemas/Query'
description: List of company names to match
minItems: 1
ValidationErrorDetail:
type: object
description: Single field validation error
properties:
field:
type: string
description: Location of the validation error (e.g. body.Parameters.portfolio)
example: body.Parameters.portfolio
message:
type: string
description: Human-readable error message
example: field required
type:
type: string
description: Machine-readable error type
example: value_error.missing
Error:
type: object
description: Standard error envelope used by the API
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
description: Machine-readable error code
example: BAD_REQUEST
message:
type: string
description: Human-readable error message
example: Invalid request parameters
details:
description: Optional structured details about the error
oneOf:
- type: array
items:
$ref: '#/components/schemas/ValidationErrorDetail'
- type: object
- type: string
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT bearer token.