Retrieve an Instant Verification
curl --request GET \
--url https://api.example.com/v1/instant-verifications/{verification_id}/import requests
url = "https://api.example.com/v1/instant-verifications/{verification_id}/"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/instant-verifications/{verification_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/instant-verifications/{verification_id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/instant-verifications/{verification_id}/"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/instant-verifications/{verification_id}/")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/instant-verifications/{verification_id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyInstant Verification
Retrieve an Instant Verification
Get the details and results of a specific instant verification request
GET
/
v1
/
instant-verifications
/
{verification_id}
/
Retrieve an Instant Verification
curl --request GET \
--url https://api.example.com/v1/instant-verifications/{verification_id}/import requests
url = "https://api.example.com/v1/instant-verifications/{verification_id}/"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/instant-verifications/{verification_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/instant-verifications/{verification_id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/instant-verifications/{verification_id}/"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/instant-verifications/{verification_id}/")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/instant-verifications/{verification_id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyDescription
Retrieve the current state and results of a specific instant verification request. When the verification status iscompleted or partial, the results object will contain employment and income data.
Authentication
This endpoint requires API credentials to be provided in the request header:- X-Access-Client-ID (header)
- X-Access-Secret (header)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
verification_id | string | Yes | The unique identifier for the instant verification request |
Response
The endpoint returns the full Instant Verification object in JSON format, including results when the verification has completed.Example Response
{
"id": "iv_8f3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c",
"status": "completed",
"created_at": "2025-09-15T14:30:00.000000Z",
"completed_at": "2025-09-15T14:30:12.345678Z",
"subject": {
"first_name": "Jane",
"last_name": "Doe",
"date_of_birth": "1990-05-14",
"ssn": "1234"
},
"addresses": [
{
"street": "742 Evergreen Terrace",
"city": "Springfield",
"state": "IL",
"zip": "62704",
"country": "US",
"from_date": "2021-03-01",
"to_date": null
},
{
"street": "100 Main St",
"city": "Shelbyville",
"state": "IL",
"zip": "62565",
"country": "US",
"from_date": "2018-06-15",
"to_date": "2021-02-28"
}
],
"results": {
"employments": [
{
"employer_name": "Acme Corporation",
"job_title": "Software Engineer",
"start_date": "2021-04-01",
"end_date": null,
"is_active": true,
"income": "95000.00",
"income_unit": "YEARLY",
"pay_frequency": "BW"
},
{
"employer_name": "Initech LLC",
"job_title": "Junior Developer",
"start_date": "2018-08-01",
"end_date": "2021-03-15",
"is_active": false,
"income": "65000.00",
"income_unit": "YEARLY",
"pay_frequency": "SM"
}
],
"income_summary": {
"current_annual_income": "95000.00",
"previous_annual_income": "65000.00",
"currency": "USD"
},
"confidence_score": 0.95,
"sources": ["national_employment_database", "credit_bureau"]
},
"tracking_info": "app-ref-98765"
}
Related Endpoints
- Instant Verification object - Object attributes and data structure
- Create an instant verification - POST endpoint for creating a verification
- List all instant verifications - GET endpoint for listing verifications
- Instant Verification webhooks - Webhook notifications for verification events