Getting Started

Before making actual API calls, please ensure that you are setup fully to do so. Given below are the are the pre-requisites for making the best use of Open PermID API, and will guide you through the following steps:

Create your PermID account and the associated access token

The PermID Record Matching API requires an access-token to be provided for every API call that you wish to make. This access token (also know as API key) is unique and is associated with only your PermID account . 

Note: The same token can be used for all PermID APIs (Entity Search, Record Matching and Intelligent Tagging)

Exsitng User: If you are an existing user  you would have received the access token via email when you registered with Alternateively, once logged in to, you can view your access tokenin two ways:  

1. At the top right of the page, click on your emaild address and then on Display my API token, OR

2. Click on APIs and then on Display my API token

New User: If you are a new user, you must first register with To Register, please follow these steps: 

  1. Visit the portal (
  2. Click on the 'REGISTER' link at the top right corner
  3. Fill in the registration form with the required information and click on Register to MyRefinitiv button
  4. Complete the registration process, as instructed. On successful registration, the access token will be assigned and emailed to you


If you have any querstions regarding the use of  Record Matching API or any support questions in general, please use the Q&A section of the Developer Community and raise them there.