OpenSanctions

OpenSanctions Reconciliation API

The Reconciliation Service provides four separate endpoints that work in concert to implement the data matching API used by OpenRefine, Wikidata and several other services and utilities.

Documentation GitHub OpenAPI

Operations 1

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /reconcile/{dataset} Get the OpenRefine reconciliation service manifest · Reconciliation manifest #

Ask an LLM

“How do I connect OpenRefine to OpenSanctions to bulk match names in a spreadsheet?”

“What reconciliation service manifest does a dataset expose for Refine-compatible tools?”

Tell an agent

Get the reconciliation manifest for the {dataset} collection.

Give me the Refine reconciliation endpoint details for {dataset} so I can add it to OpenRefine.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/opensanctions:opensanctions-reconciliation-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: OpenSanctions Reconciliation API
  description: '## Introduction


    The OpenSanctions API allows users to search and query

    the OpenSanctions entity graph.'
  termsOfService: https://www.opensanctions.org/docs/terms
  contact:
    name: OpenSanctions
    url: https://www.opensanctions.org/
    email: info@opensanctions.org
  version: yente 5.5.0
  x-logo:
    url: https://assets.opensanctions.org/images/ura/logo_text_spaced.svg
  externalDocs:
    description: Home page
    url: https://www.opensanctions.org
tags:
- name: Reconciliation
  description: The Reconciliation Service provides four separate endpoints that work in concert to implement the data matching API used by OpenRefine, Wikidata and several other services and utilities.
  externalDocs:
    description: W3C Community API specification
    url: https://reconciliation-api.github.io/specs/latest/
paths:
  /reconcile/{dataset}:
    get:
      tags:
      - Reconciliation
      summary: Reconciliation manifest
      description: 'Reconciliation API, emulates Google Refine API. This endpoint can be used

        to bulk match entities against the system using an end-user application like

        OpenRefine. The reconciliation API uses the same

        search and matching functions as the matching API and will also produce

        scores that reflect additional properties like country or date of birth, if

        specified.


        Tutorial: Using OpenRefine to match entities in a spreadsheet.'
      operationId: reconcile_reconcile__dataset__get
      parameters:
      - name: dataset
        in: path
        required: true
        schema:
          type: string
          description: Data source or collection name to scope the query to.
          examples:
          - default
          title: Dataset
        description: Data source or collection name to scope the query to.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FreebaseManifest'
        '400':
          description: Invalid query
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    FreebaseManifestExtend:
      properties:
        propose_properties:
          $ref: '#/components/schemas/FreebaseManifestExtendProposeProperties'
        propose_settings:
          items:
            $ref: '#/components/schemas/FreebaseManifestExtendPropertySetting'
          type: array
          title: Propose Settings
      type: object
      required:
      - propose_properties
      - propose_settings
      title: FreebaseManifestExtend
    FreebaseManifestExtendPropertySetting:
      properties:
        name:
          type: string
          title: Name
        label:
          type: string
          title: Label
        type:
          type: string
          title: Type
        default:
          title: Default
        help_text:
          type: string
          title: Help Text
        choices:
          items:
            $ref: '#/components/schemas/FreebaseManifestExtendPropertySettingChoice'
          type: array
          title: Choices
          default: []
      type: object
      required:
      - name
      - label
      - type
      - default
      - help_text
      title: FreebaseManifestExtendPropertySetting
    FreebaseManifestExtendProposeProperties:
      properties:
        service_url:
          type: string
          minLength: 1
          format: uri
          title: Service Url
        service_path:
          type: string
          title: Service Path
      type: object
      required:
      - service_url
      - service_path
      title: FreebaseManifestExtendProposeProperties
    FreebaseManifestSuggestType:
      properties:
        service_url:
          type: string
          minLength: 1
          format: uri
          title: Service Url
        service_path:
          type: string
          title: Service Path
      type: object
      required:
      - service_url
      - service_path
      title: FreebaseManifestSuggestType
    FreebaseManifestPreview:
      properties:
        url:
          type: string
          title: Url
        width:
          type: integer
          title: Width
        height:
          type: integer
          title: Height
      type: object
      required:
      - url
      - width
      - height
      title: FreebaseManifestPreview
    FreebaseManifestExtendPropertySettingChoice:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
      type: object
      required:
      - id
      - name
      title: FreebaseManifestExtendPropertySettingChoice
    ErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          examples:
          - Detailed error message
      type: object
      required:
      - detail
      title: ErrorResponse
    FreebaseManifestView:
      properties:
        url:
          type: string
          title: Url
      type: object
      required:
      - url
      title: FreebaseManifestView
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    FreebaseType:
      properties:
        id:
          type: string
          title: Id
          examples:
          - Person
        name:
          type: string
          title: Name
          examples:
          - People
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
      type: object
      required:
      - id
      - name
      title: FreebaseType
    FreebaseManifestSuggest:
      properties:
        entity:
          $ref: '#/components/schemas/FreebaseManifestSuggestType'
        type:
          $ref: '#/components/schemas/FreebaseManifestSuggestType'
        property:
          $ref: '#/components/schemas/FreebaseManifestSuggestType'
      type: object
      required:
      - entity
      - type
      - property
      title: FreebaseManifestSuggest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FreebaseManifest:
      properties:
        versions:
          items:
            type: string
          type: array
          title: Versions
          examples:
          - - '0.2'
        name:
          type: string
          title: Name
          examples:
          - yente
        identifierSpace:
          type: string
          minLength: 1
          format: uri
          title: Identifierspace
        schemaSpace:
          type: string
          minLength: 1
          format: uri
          title: Schemaspace
        documentation:
          type: string
          minLength: 1
          format: uri
          title: Documentation
        batchSize:
          type: integer
          title: Batchsize
        view:
          $ref: '#/components/schemas/FreebaseManifestView'
        preview:
          $ref: '#/components/schemas/FreebaseManifestPreview'
        suggest:
          $ref: '#/components/schemas/FreebaseManifestSuggest'
        extend:
          $ref: '#/components/schemas/FreebaseManifestExtend'
        defaultTypes:
          items:
            $ref: '#/components/schemas/FreebaseType'
          type: array
          title: Defaulttypes
      type: object
      required:
      - versions
      - name
      - identifierSpace
      - schemaSpace
      - documentation
      - batchSize
      - view
      - preview
      - suggest
      - extend
      - defaultTypes
      title: FreebaseManifest