Resolve one or more provider IDs to entities (primary endpoint)

The primary bulk translation endpoint. Given a list of (provider, id, type?) items, returns the matching entities. Use this both for single lookups (one-element array) and bulk translation (up to 100 per request).

Translation workflow — to translate N Opta IDs into Wyscout IDs in one call:

POST /batch/resolve
{ "items": [{"provider": "opta", "id": "..."}, ...],
  "targets": ["wyscout"] }

Each result's external_ids will contain only the requested target providers, dramatically reducing payload size. The from field on every result echoes the input so callers can correlate regardless of array order or not_found gaps.

Error handling — malformed items return inline errors (missing_fields, unknown_provider, not_found) rather than failing the whole batch. The response count always equals items.length; position is preserved.

Maximum 100 items per request.

Request body

targetsProviderName[]

Optional filter on response external_ids. When provided, each matched entity's external_ids will contain only the named providers, and the qid convenience field is populated only if wikidata is in the list. Unknown provider names are silently ignored. Useful for trimming response size when you only need one or two target IDs per translation.

Response

Batch resolve results. Position is preserved, count equals items.length.

countinteger

v1

Resolve one or more provider IDs to entities (primary endpoint)

Request body

Response