Getting Started

Step 1: Obtain your API access

The first step is for you to get the API access so that you can start hitting the endpoints in our sandbox environment. Please reach out to your Dynata Account Manager to request for an API account.

Step 2: Make a Test API Request

To make sure you are able to call the Dynata endpoints, call the Auth API to get an access token. This is the first step towards integrating with Dynata.

All Dynata endpoints require you to authenticate using your API Keys.

Authentication
Example Request
curl -X POST \
  https://api.researchnow.com/auth/v1/token/password \
  -H 'Content-Type: application/json' \
  -d '{"clientId": "api", "password": "<Your Password>", "username": "<Your username>"}'
Authentication
Example Response
{
  "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJJcUF3amNmX18xTWhqaTk1dkRQXzVMa2RQejRHNDhPTkdlXzFFOHlZMzZjIn0.eyJqdGkiOiIzMzhiMjI3Ny1iZjRlLTRjNWEtYTNiYy01YTI2MjFkMmJmNzciLCJleHAiOjE1NTYwNjcwMzUsIm5iZiI6MCwiaWF0IjoxNTU2MDY1MjM1LCJpc3MiOiJodHRwczovL2tleWNsb2FrLnByb2QucGUucmVzZWFyY2hub3cuY29tL2F1dGgvcmVhbG1zL3BlIiwiYXVkIjpbInNhbXBsaWZ5IiwiY2l0eS1oYWxsIiwiYXBpLWdhdGV3YXkiLCJzdXJ2ZXlxYSIsImFjY291bnQiXSwic3ViIjoiNzY5YjNlNzQtZmM0Mi00NzY0LWFjNmItZjRjNmY4ODgzYzNkIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoiYXBpIiwiYXV0aF90aW1lIjowLCJzZXNzaW9uX3N0YXRlIjoiMzQ4ZGIwMDEtMDVlMi00M2UyLWI1OGItMTMwYmY0YTU4Zjc3IiwiYWNyIjoiMSIsInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsic2FtcGxpZnkiOnsicm9sZXMiOlsiYWNjZXNzLXNhbXBsaWZ5Il19LCJjaXR5LWhhbGwiOnsicm9sZXMiOlsiYWNjZXNzLWNpdHktaGFsbCJdfSwiYXBpLWdhdGV3YXkiOnsicm9sZXMiOlsiYWNjZXNzLXNhbXBsZS1xYSIsImFjY2Vzcy1jdXN0b21lciIsImFjY2Vzcy1zYW1wbGUiXX0sInN1cnZleXFhIjp7InJvbGVzIjpbImFjY2Vzcy1zdXJ2ZXlxYSJdfSwiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiIiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJycG9kZGFyQHJlc2VhcmNobm93LmNvbSIsImVtYWlsIjoicnBvZGRhckByZXNlYXJjaG5vdy5jb20ifQ.o9zPmyW9rWMYqkMmCLTCgBaS1xwO0qjbFYS3kSahXLcWoSvEjkMT7DxVVW-mryNgLoPXs7EsbDr6dygZdM38v-V8BlUddKtlTIYB72Ls4BZWTkZS2IjOyWMhe-h-GUgSxa2f8IY9GV5Nx5KdZT2t08qUQ46gUoE-nH94FbGRFIkXmn-xyyM13Mt-51RhkYHqaBhNxRf0R7hGwAQi8INb8OzQmRXmweAVGKNcL18YUn7bN0yjAu15qsRZhyaaiB4fOJbEpn7qm31seuLRIKTPIkHhxQTI1nR_CyWw2mb1v5t71-w-9J8uRqaKu3-LrZt3vHoRF76oy-VSmmBrAROInw",
  "expiresIn": 1800,
  "refreshExpiresIn": 3600,
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJkYzdlN2Q1Mi04MTg2LTQ5MDEtOWVhNC02NGZkNjVlMGIwMGQifQ.eyJqdGkiOiIzN2QzNTc3Yi1kMzFlLTQxYzQtYjE1ZS1mNDk4NmVmOTllMmMiLCJleHAiOjE1NTYwNjg4MzUsIm5iZiI6MCwiaWF0IjoxNTU2MDY1MjM1LCJpc3MiOiJodHRwczovL2tleWNsb2FrLnByb2QucGUucmVzZWFyY2hub3cuY29tL2F1dGgvcmVhbG1zL3BlIiwiYXVkIjoiaHR0cHM6Ly9rZXljbG9hay5wcm9kLnBlLnJlc2VhcmNobm93LmNvbS9hdXRoL3JlYWxtcy9wZSIsInN1YiI6Ijc2OWIzZTc0LWZjNDItNDc2NC1hYzZiLWY0YzZmODg4M2MzZCIsInR5cCI6IlJlZnJlc2giLCJhenAiOiJhcGkiLCJhdXRoX3RpbWUiOjAsInNlc3Npb25fc3RhdGUiOiIzNDhkYjAwMS0wNWUyLTQzZTItYjU4Yi0xMzBiZjRhNThmNzciLCJyZWFsbV9hY2Nlc3MiOnsicm9sZXMiOlsib2ZmbGluZV9hY2Nlc3MiLCJ1bWFfYXV0aG9yaXphdGlvbiJdfSwicmVzb3VyY2VfYWNjZXNzIjp7InNhbXBsaWZ5Ijp7InJvbGVzIjpbImFjY2Vzcy1zYW1wbGlmeSJdfSwiY2l0eS1oYWxsIjp7InJvbGVzIjpbImFjY2Vzcy1jaXR5LWhhbGwiXX0sImFwaS1nYXRld2F5Ijp7InJvbGVzIjpbImFjY2Vzcy1zYW1wbGUtcWEiLCJhY2Nlc3MtY3VzdG9tZXIiLCJhY2Nlc3Mtc2FtcGxlIl19LCJzdXJ2ZXlxYSI6eyJyb2xlcyI6WyJhY2Nlc3Mtc3VydmV5cWEiXX0sImFjY291bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtYWNjb3VudC1saW5rcyIsInZpZXctcHJvZmlsZSJdfX0sInNjb3BlIjoiIn0.-sVowip4RPRlwRTlCYrrnwcdLda2OWSoHWunZtrej7w"
}

You are now ready to consume all other Dynata Sample API endpoints. Please read Building the Integration for understanding our recommended approach for integrating with all endpoints.