DRNsights Investigation
Welcome to the DRNSights Investigation API documentation. This documentation will describe the various DRN Insurance APIs available, expected inputs, and API returns.
The API documentation will start with a general overview of the design and technology that has been implemented, followed by reference information about specific endpoints.
Articles
Setup
The DRN Team will provide a client_id and client_secret. Utilize these values in the request parameters provided to receive your Authorization Bearer Token to be used in the header of your future requests. These tokens expire every 60 minutes by default, so be sure you have a way to programmatically check the status and / or refresh your tokens.
Parameters
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.
Authorization
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.
Url: https://insurance.drndata.com/oauth/token
Example Request:
"grant_type": "client_credentials", "client_id": “”, "client_secret": "", "scope": ""
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.
Requests
The rest of the API URLs referenced in this documentation start with the following base part:
https://insurance.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.
Vehicle Sighting Search
This API allows you to obtain vehicle sightings in a programmatic way using conventional HTTP requests. The endpoints allow you to make calls to retrieve information or to execute actions efficiently.
Request Detail(s)
In order to receive the full details of the vehicle sightings, you can request this with the following:
Url: https://insurance.drndata.com/api-client/vehicle-sightings/detail
Example Response:
{
"data": {
"start": "2020-05-30 00:00:00",
"end": "2023-05-30 23:59:59",
"total": {TotalSightingsHere),
"last_30": {SightingsHere},
"last_60": {SightingsHere},
"last_90": {SightingsHere},
"vehicle": {
"vin": "{VINHere}",
Example Response:
{
"data": {
"id": 500,
"created_at": "2023-05-30T23:58:37.000000Z",
"reference": "TEST",
"vehicle": {
"year": null,
"vin": "11111111111111111",
"model": null,
"make": null,
"plate": {
"number": "NPB9775",
"state": "TX"
}
},
"locations": [
{
"location": {
"street1": "{StreetAddressHere}",
"street2": null,
"street3": null,
"city": "{CityHere}",
"state": "{StateHere}",
"postal_code": "{PostalCodeHere}",
"country": "US",
"latitude": "{CoordinatesHere}",
"longitude": "{CoordinatesHere}",
"type": "Residential"
},
"sightings": {SightingsHere},
"first": {
"scan_date": "2020-12-01 23:17:15"
},
"last": {
"scan_date": "2023-05-25 01:54:02"
},
"visits": 701,
"address_score": {
"confirmed_visits": "17,47,57,580",
"confirmed_score": "9999"
},
"popular_time": "NIGHT",
"scan_image_url": [
{
"plate": "{PlateImageUrlHere}",
"car": "{CarImageUrlHere}"
}
]
}
],
"metrics": {
"sightings": {
"total": 159
}
]
}
}
Picture Proof
Given a VIN and a time frame can return a list of images of that vehicle within that time frame.
GET /api/Insurance/PictureProof
URLs
The following endpoint will return scans based on the parameters passed:
https://platform.drndata.com/api/PictureProof
PARAMETERS
| Param Name | Types | Required |
|---|---|---|
| vin | Str | Y |
| start | date | N |
| end | date | N |
| policy_id | int | N |
Example Response:
{
"Plate": "ABC123",
"PlateState": "TX",
"Scans": [
{
"ScanDate": "2021-12-27 22:00:43.507",
"ScanImageUrl": "http://www.drnweb.net/webrepo/gui/GetCarImage.aspx?strEventID=SAMPLEDID"
},
{
"ScanDate": "2021-11-17 13:30:46.673",
"ScanImageUrl": "http://ww
w.drnweb.net/webrepo/gui/GetCarImage.aspx?strEventID=SAMPLEDID2"
}
]
}
Address Analysis
The DRNSights for Insurance API allows you to obtain Address Analysis data in a programmatic way using conventional HTTP requests. The endpoints allow you to make calls to retrieve information or to execute actions efficiently.
Request Detail(s) Address Analysis
In order to receive the full details of the sightings at a location, you can request this with the following:
Url: https://insurance.drndata.com/api-client/address-analysis/detail
Example Request:
"address": {
"street": "XXXX 60th Street",
"city": "Brooklyn",
"state": "NY",
"postal_code": "11204"
},
"radius": "2",
"date_range": {
"start_date": "2023-06-01",
"end_date": "2023-06-30"
},
"vehicle": {
"vin": "11111111111111111",
"plate": "",
"plate_state": ""
},
"reference": "TEST"
}
Example Response:
"data": {
"id": 935,
"created_at": "2023-09-08T14:58:57.000000Z",
"reference": "N\\/A",
"Location": {
"street1": "XXXX 60th Street",
"street2": null,
"street3": null,
"city": "Brooklyn",
"state": "NY",
"postal_code": "11204",
"country": "US",
"latitude": "40.62369000000",
"longitude": "-73.98951400000",
"type": "Other",
"target_vehicle": {
"year": "2001",
"vin": "11111111111111111",
"model": "ODYSSEY",
"make": "HONDA",
"plate": {
"number": "4444444",
"state": "NY"
}
},
"radius": "2 miles",
"date_range": "2023-06-01_to_2023-06-30"
},
"Visits": [
{
"Visit": {
"scan_date": "2023-06-30 04:30:55",
"vehicles_sighted": 48,
"target_sighted": "No",
"vehicles": [
{
"plate": {
"number": "4444444",
"state": "NY"
},
"scan_image_url": {
"plate": "https:\\/\\/images.drndata.com\\/2a857b6f-764c-4c2c-8f0c-52c6a0b35da8-p.jpg",
"car": "https:\\/\\/images.drndata.com\\/2a857b6f-764c-4c2c-8f0c-52c6a0b35da8-c.jpg",
"scan_date": "2023-06-30 04:30:55"
}
},
{
{
"plate": {
"number": "4444444",
"state": "NY"
},
"scan_image_url": {
"plate": "https:\/\/images.drndata.com\/f2086035-7bb9-4586-8753-7337ea67dc9d-p.jpg",
"car": "https:\/\/images.drndata.com\/f2086035-7bb9-4586-8753-7337ea67dc9d-c.jpg",
"scan_date": "2023-06-05 07:33:38"
}
}
]
}
}
]
}
}