When passing parameters to create or update an object, you should pass a JSON object containing the appropriate attribute names and values as key-value pairs. When you use this format, you should specify that you are sending a JSON object in the header by setting the Content-Type header to application/json.

curl -X POST "https://drnsights.drndata.com/api-client/" -H “Authorization . . . “
-H "Content-Type: application/json" 
-d { . . . }

To interact programmatically with the data in your account, the server will require you to present an Authorization Bearer Token. You can request this with the following request using your client_id and client_secret.

Example Request:

curl -d "client_id={ClientIdHere}&\ client_secret={ClientSecretHere}&\ grant_type=client_credentials" https://drnsights.drndata.com/oauth/token/

Example Response:

{"token_type":"Bearer","expires_in":1296000,"access_token":"{AccessTokenHere}"}

When an API request is made, a bearer token is required in the header. The client_id and client_secret are used to obtain a bearer token. Tokens are obtained through an API POST request to the following URL: https://drnsights.drndata.com/oauth/token/. The form of the API POST should be as follows:

<pre>{

      client_id: { client id },

      client_secret: { client secret },

      grant_type: 'client_credentials'

}</pre>

Bearer tokens expire after 15 days. When a bearer token has expired, please request another at https://drnsights.drndata.com/oath/token. If you send a request before your token is expired, it will refresh for an additional15 days.

The rest of the API URLs referenced in this documentation start with the following base part:
https://drnsights.drndata.com/api-client
Any tool that is fluent in HTTP can communicate with the API simply by properly formatting and requesting from the correct URI. Requests should be made using the HTTPS protocol so that traffic is encrypted. The interface responds to different methods depending on the action required.

Example Request:

curl -X GET "https://drnsights.drndata.com/api-client/user" -H "accept: /" -H "Authorization: Bearer {TOKEN HERE}"

Example Response:

{
  "data": {
  "id": 154,
  "email": "10ae17fe-c10d-4d7b-a731-9641958d0aac@",
  "is_active": true,
  "first_name": "1217 TEST",
  "middle_name": null,
  "last_name": "Service Account",
  "full_name": "Service Account, 1217 TEST ",
  "name": "1217 TEST Service Account",
  "created_at": "2020-12-17T21:06:01+00:00",
  "mobile_phone": null,
  "office_phone": null,
  "timezone": "America/Chicago",
  "login_scope": 3
 }
}

Example Request:

curl-X POST "https://drnsights.drndata.com/api-client/record" -H "accept: /" -H "Authorization: Bearer {TOKEN HERE}”

Example Response:

{
  "data": [
   {
   "id": 345045,
   "created_at": "2020-11-06T22:17:04+00:00"
   },
   {
   "id": 698916,
   "created_at": "2021-03-04T19:42:53+00:00"
   },
   {
   "id": 698917,
   "created_at": "2021-03-04T19:42:53+00:00"
   },
   { T R U N C A T E D }
   "path": "https://drnsights.drndata.com/api-client/record",
   "per_page": 15,
   "to": 15,
   "total": 1001
  }
}

Records are created using a vin parameter. Here’s an example request:

curl -X POST "https://drnsights.drndata.com/api-client/product/48/record" -H "accept: /" -H "Authorization: Bearer {TOKEN HERE}" -H "Content-Type: application/json" -d "{\"vin
\":\"11111111111111111\"}"

Example Response:

{"data":{"id":818101,"created_at":"2021-04-08T00:26:22+00:00"}}

curl -X POST "https://drnsights.drndata.com/api-client/product/48/record" -H "accept: /" -H "Authorization: Bearer {TOKEN HERE}" -H "Content-Type: application/json" -d "{\"ssn
\":\"123456789\", \”reference\”:\”testing\”}"

Example Response:

{"data":{"id":818101,"created_at":"2021-04-08T00:26:22+00:00"}}

curl -X POST "https://drnsights.drndata.com/api-client/record/817966/address/create" -H "accept: /" -H "Authorization: Bearer {TOKEN HERE}" -H "Content-Type: application/json" -d "{\"street1\":\"123 Main\",\"street2\":\"Suite 678\",\"city\":\"Here\",\"state\":\"TX\",\"postal_code\":75074}

curl -X POST "https://drnsights.drndata.com/api-client/record/817966/person/create" -H "accept: /" -H "Authorization: Bearer {TOKEN HERE}" -H "Content-Type: application/json" -d "{\"first_name\":\"Brak\",\"last_name\":\"Spaceman\",\"is_primary\":\"True\"}"

You can utilize the appends parameter to add Vehicle information, Addresses, People, Record Metrics, and Address Metrics to the filtered record. For format reproduction, all appends are shown. However, they can be utilized individually or in any combination.

curl -X POST "https://drnsights.drndata.com/api-client/record/817966" -H "accept: /" -H "Authorization: Bearer {TOKEN HERE}" -H "Content-Type: application/json" -d "{\"filter\":{\"vehicle_vin:is\":\"11111111111111111\"},\"appends\":[\"record.addresses\",\"record.people\",\"record.vehicles\",\"record.metrics\",\"address.metrics.address_score\"]}"

Status and reason codes can be found above by requesting the available data types.

curl -X POST "https://drnsights.drndata.com/api-client/product/48/record/699604/status" -H "accept: /" -H "" Authorization: Bearer {TOKEN HERE}" -H "Content-Type: application/json" -d "{\"status_id\":\"3\",\"reason_id\":7,\"other_reason\":\"API Testing\",\"closed_date\":\"2020-10-28 21:39:45\"}"