post https://api.skipengine.com/v4/service
**If you use the Base Complete API v1 /service endpoint, please look at the Breaking Changes section before switching to v2!
Overview of Base Complete v2 Changes
Biggest Changes
-
Increased number of Phones returned
- We'll return as many phone numbers as we can find now instead of the top 3. This means you can get double digit numbers of phones returned. They'll be returned in order of confidence.
-
Increased number of Emails returned
- Same as with phones, we'll return as many as we can find for the searched person in order of confidence
-
Relatives
- Array of possible relatives returned with full demographics and contact data (phones and emails)
- Deceased flag and date of death for the searched person and returned relatives
- Date of birth returned for the searched person and all relatives
-
Address History
- A new array of associated addresses is returned for the searched person. This does not necessarily mean ownership, but in some cases it will be other properties owned by the searched person, and places they've lived.
-
Dramatically improved speed
- The new API is 100x faster than the prior version
-
Improved reliability
- The new API is multiples more reliable with a 99.999% uptime rating
-
New caching option (added price per search)
- The new API will cache searches for you over a period of time you can define with us. This way, you won't pay if your customers search the same person multiple times in the given period. You could pass this savings on to your customers, or increase your profit margin. For this option, it does cost more per search since your volume will be lower, but it's a very small increase. We'll also return a Cached flag, to let you know if the returned data was from a cached response or not.
Breaking Changes
- This API does not provide DNC or Litigator scrubs. (we found most weren't using it, and removing it dramatically improved the speed of the lookup). These fields will not be present in the phone number objects.
- Phone numbers and Emails are now returned in a list instead of dictionary ({} (v1) -> [] (v2)) to accommodate the dramatic increase of phones and emails returned for both the searched person and the relatives.
- This API will no longer return a property object with the search. You can enrich v2 Base Complete results with the Property Object using the Property Complete API for $0.0025 / record.
Responses
When using the API, you may get different types of responses. Here are what each of our API status codes mean and how you can use them to debug any issues accessing our API.
200 | Successful API Call |
400 | Bad request with descriptive response as to why it failed |
401 | Authorization error (check API Key usage) |
500 | Internal Sever Error (If you get this, email support [email protected]) |