Skip to content

Find a person

Use the onboarding API to synchronously find persons, either for autofill, validation, etc.

Before you begin

The provided example values in this guide must be changed with the values of your client. Replace <client_id> with your client id, and <client_secret> with your client secret.

Your first find request

Step 1 - Setup

You must have already signed up as an organization with Dun & Bradstreet and have your sandbox credentials from the developer portal. See Getting started guide for help.

Step 2 - Authentication

First, you will need an access_token from the Authentication API (POST:https://login.bisnode.com/sandbox/v1/token.oauth2).

Don't forget to change credentials

Don't forget to replace <client_id> with your client id, and <client_secret> with your client secret.

curl -X POST https://login.bisnode.com/sandbox/v1/token.oauth2 \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&scope=bci" \
     -u "<client_id>:<client_secret>"

The property access_token from the response should be used for all other API requests in the Authorization header as the Bearer token.

Step 3 - Find person

Use POST:/v3/markets/<market>/persons/_find to find a person.

curl -X POST https://sandbox-api.bisnode.com/consumer-intelligence/v3/markets/SE/persons/_find \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <access_token>" \
     -d '{
       "legalId": "196909234701"
     }'