Retrieve Session

curl --request GET \
  --url https://api.deepidv.com/v1/sessions/{id}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.deepidv.com/v1/sessions/{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.deepidv.com/v1/sessions/{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))

}

require 'uri'
require 'net/http'

url = URI("https://api.deepidv.com/v1/sessions/{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_body

{
  "session_record": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "organization_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "user_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "sender_user_id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "status": "SUBMITTED",
    "type": "session",
    "session_progress": "COMPLETED",
    "location": {
      "country": "Canada"
    },
    "workflow_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "bank_statement_request_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
    "workflow_steps": ["ID_VERIFICATION", "FACE_LIVENESS", "PEP_SANCTIONS"],
    "created_at": "2025-01-15T10:30:00.000Z",
    "updated_at": "2025-01-15T10:45:00.000Z",
    "submitted_at": "2025-01-15T10:42:00.000Z",
    "meta_data": {
      "applicantSubmissionIp": "192.168.1.1, 10.0.0.1",
      "applicantSubmissionDevice": "Mac",
      "applicantViewTime": "2025-01-15T10:35:00.000Z",
      "applicantSubmissionBrowser": "Safari",
      "applicantSubmissionLocation": "Chicago, United States",
      "applicantSubmissionLocationDetails": {
        "accuracyRadius": 500,
        "continent": "North America",
        "country": "United States",
        "countryIsoCode": "US",
        "latitude": 41.8483,
        "longitude": -87.6517,
        "subdivision": "Illinois",
        "timeZone": "America/Chicago"
      },
      "failureData": {
        "failedAttempts": 1,
        "attempts": [
          { "reason": "NO_FACE_DETECTED", "slot": "PRIMARY", "failedAt": "2025-01-15T10:37:00.000Z" }
        ]
      },
      "declinedData": {
        "declined": true,
        "score": 2,
        "declinedAt": "2025-01-15T10:43:00.000Z",
        "reason": {
          "code": "LOW_FACE_MATCH",
          "detail": "Face match confidence is low",
          "slot": "PRIMARY",
          "severity": "CRITICAL"
        }
      }
    },
    "uploads": {
      "id_front": true,
      "id_back": true,
      "secondary_id_front": true,
      "secondary_id_back": true,
      "tertiary_id_front": true,
      "tertiary_id_back": true,
      "selfie_front": true,
      "selfie_right": true,
      "selfie_left": true,
      "faceliveness": true,
      "hold_up_3_fingers": true,
      "pdf_summary": true
    },
    "analysis_data": {
      "created_at": "2025-01-15T10:43:00.000Z",
      "id_matches_selfie": true,
      "faceliveness_score": 99.49,
      "id_matches_face_capture": true,
      "id_matches_liveness": true,
      "id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.56, "sharpness": 38.90 },
            "bounding_box": { "height": 0.32, "left": 0.11, "top": 0.33, "width": 0.19 },
            "pose": { "pitch": 11.74, "yaw": 3.85, "roll": -2.84 },
            "landmarks": [
              { "x": 0.164, "y": 0.458, "type": "eyeLeft" },
              { "x": 0.248, "y": 0.449, "type": "eyeRight" },
              { "x": 0.215, "y": 0.507, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 91.22 }
          }
        ],
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.64 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.15 },
          { "type": "MIDDLE_NAME", "value": "", "confidence": 99.15 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 95.46 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.87 },
          { "type": "DATE_OF_ISSUE", "value": "2023/06/30", "confidence": 95.40 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 90.02 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 0.66 },
          { "type": "ADDRESS", "value": "123 MAIN ST", "confidence": 94.86 },
          { "type": "CITY_IN_ADDRESS", "value": "SPRINGFIELD IL", "confidence": 66.81 },
          { "type": "STATE_IN_ADDRESS", "value": "IL", "confidence": 47.99 },
          { "type": "CLASS", "value": "G", "confidence": 97.54 },
          { "type": "RESTRICTIONS", "value": "X", "confidence": 97.29 }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": true,
        "age_restriction_pass": true
      },
      "secondary_id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.30, "sharpness": 38.90 },
            "bounding_box": { "height": 0.30, "left": 0.12, "top": 0.35, "width": 0.18 },
            "pose": { "pitch": 11.98, "yaw": 3.80, "roll": -2.13 },
            "landmarks": [
              { "x": 0.174, "y": 0.466, "type": "eyeLeft" },
              { "x": 0.253, "y": 0.460, "type": "eyeRight" },
              { "x": 0.219, "y": 0.513, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 87.16 }
          }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": false,
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.63 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.17 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 94.95 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.64 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 94.87 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 90.14 }
        ],
        "age_restriction_pass": true
      },
      "tertiary_id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.39, "sharpness": 38.90 },
            "bounding_box": { "height": 0.30, "left": 0.14, "top": 0.36, "width": 0.18 },
            "pose": { "pitch": 11.39, "yaw": 3.27, "roll": -3.04 },
            "landmarks": [
              { "x": 0.191, "y": 0.479, "type": "eyeLeft" },
              { "x": 0.270, "y": 0.472, "type": "eyeRight" },
              { "x": 0.239, "y": 0.526, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 92.90 }
          }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": false,
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.60 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.15 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 95.75 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.78 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 92.32 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 90.11 }
        ],
        "age_restriction_pass": true
      },
      "pep_sanctions_data": {
        "peps": [
          {
            "name": "John Smith",
            "country": "United Kingdom",
            "score": 1,
            "id": "Q180589",
            "datasets": ["ann_pep_positions", "wd_peps"],
            "birth_date": "1964-06-19"
          },
          {
            "name": "Jane Smith",
            "country": "Unknown",
            "score": 0.776,
            "id": "Q19360548",
            "datasets": ["wd_peps", "ann_pep_positions"],
            "birth_date": "1923-06-23"
          }
        ],
        "sanctions": null,
        "both": null
      },
      "compare_faces_data": {
        "face_match_confidence": 99.92,
        "face_match_result": {
          "face": {
            "landmarks": [
              { "x": 0.164, "y": 0.458, "type": "eyeLeft" },
              { "x": 0.248, "y": 0.449, "type": "eyeRight" },
              { "x": 0.215, "y": 0.507, "type": "nose" }
            ],
            "confidence": 99.99,
            "quality": { "brightness": 97.56, "sharpness": 38.90 },
            "bounding_box": { "height": 0.32, "left": 0.11, "top": 0.33, "width": 0.19 },
            "pose": { "pitch": 11.74, "yaw": 3.85, "roll": -2.84 }
          },
          "similarity": 99.92
        }
      },
      "adverse_media_data": {
        "total_hits": 10,
        "news_exposures": {
          "violent_crime": {
            "category": "violent_crime",
            "hits": 2,
            "articles": [
              {
                "source": "serper",
                "headline": "Example headline about violent crime",
                "source_link": "https://example.com/article-1",
                "timestamp": "3 weeks ago"
              }
            ]
          },
          "terrorism": { "category": "terrorism", "hits": 0, "articles": [] },
          "regulatory": { "category": "regulatory", "hits": 0, "articles": [] },
          "financial_crime": { "category": "financial_crime", "hits": 0, "articles": [] },
          "political": { "category": "political", "hits": 0, "articles": [] },
          "uncategorized": {
            "category": "uncategorized",
            "hits": 6,
            "articles": [
              {
                "source": "serper",
                "headline": "Example uncategorized article headline",
                "source_link": "https://example.com/article-2",
                "timestamp": "Sep 14, 2025"
              }
            ]
          },
          "organized_crime": { "category": "organized_crime", "hits": 0, "articles": [] },
          "criminal_legal": {
            "category": "criminal_legal",
            "hits": 2,
            "articles": [
              {
                "source": "serper",
                "headline": "Example criminal legal article headline",
                "source_link": "https://example.com/article-3",
                "timestamp": "Sep 9, 2025"
              }
            ]
          }
        },
        "timestamp": "2025-01-15T10:43:16.338Z"
      },
      "selected_document_types": {
        "secondary": "passport",
        "tertiary": "pr_card",
        "primary": "drivers_license"
      },
      "document_risk_data": {
        "document_analysis": [
          {
            "expected_document_name": "Articles of Incorporation",
            "metadata": {
              "creator": "Microsoft\u00ae Word for Microsoft 365",
              "mod_date": "2022-04-14T03:02:41.000Z",
              "page_count": 1,
              "encrypted": false,
              "author": "John Doe",
              "producer": "Microsoft\u00ae Word for Microsoft 365",
              "creation_date": "2022-04-14T03:02:41.000Z",
              "title": null
            },
            "signals": [
              {
                "severity": "high",
                "weight": 45,
                "code": "DOCUMENT_TYPE_MISMATCH",
                "evidence": {
                  "mismatch_details": "The uploaded document does not match the expected document type 'Articles of Incorporation'.",
                  "detected_type": "Other",
                  "ai_confidence": 1,
                  "expected_type": "Articles of Incorporation"
                },
                "message": "Uploaded document does not match the expected document type"
              }
            ],
            "document_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901/a1b2c3d4-e5f6-7890-abcd-ef1234567890/1772386555165-pdf",
            "field_label": "document_1",
            "total_weight": 0,
            "max_possible_weight": 190,
            "ai_analysis": {
              "overall_assessment": "likely_fabricated",
              "claimed_dates": {
                "document_date": null,
                "statement_period": null,
                "transaction_dates": []
              },
              "content_analysis": {
                "expected_document_type": "Articles of Incorporation",
                "content_quality": "complete",
                "document_type": "Other",
                "issuing_entity": null
              },
              "document_type_mismatch_details": "The uploaded document does not match the expected document type.",
              "confidence": 1,
              "date_mismatch_details": null,
              "date_mismatch_detected": false,
              "document_type_mismatch": true,
              "reasoning": "The document provided does not match the expected 'Articles of Incorporation'. This represents a critical document type mismatch.",
              "suspicious_patterns": [
                {
                  "severity": "high",
                  "type": "Document Content Irrelevance",
                  "description": "The document content does not match 'Articles of Incorporation' as expected."
                }
              ],
              "risk_score": 95,
              "risk_indicators": [
                "Document type mismatch",
                "Irrelevant content submitted"
              ]
            },
            "risk_score": 95,
            "status_message": null,
            "status": "ok"
          }
        ],
        "analysis_timestamp": "2025-01-15T10:43:21.588Z",
        "documents_with_signals": 1,
        "overall_risk_score": 95,
        "documents_analyzed": 1
      },
      "title_search_data": {
        "last_market_sale_information": {
          "sale_type": "",
          "first_mortgage_amount": null,
          "sale_date": "2010-10-19T00:00:00",
          "sale_price": 38000,
          "deed_type": "WARRANTY DEED",
          "buyer_name": "SMITH,JOHN & JANE",
          "seller_name": "JOHNSON,ROBERT",
          "recording_date": "2010-12-15T00:00:00",
          "book_page": "47589.183",
          "current_through_date": "2026-02-17T00:00:00"
        },
        "owner_transfer_information": {
          "current_through_date": "2026-02-17T00:00:00",
          "sale_date": "2020-02-20T00:00:00",
          "recording_sale_date": "2021-05-07T00:00:00",
          "buyer_name": "SMITH JANE L",
          "sale_price": null,
          "deed_type": "QUIT CLAIM DEED",
          "seller_name": "SMITH JOHN S"
        },
        "owner_information": {
          "owner_names": "SMITH JANE L",
          "owner1_full_name": "SMITH JANE L",
          "owner2_full_name": "",
          "occupancy": "Absentee Owner",
          "owner_occupied_indicator": "N",
          "mailing_address": {
            "street_address": "1170 OAK CT",
            "city": "SPRINGFIELD",
            "state": "IL",
            "zip9": "62701-2804",
            "mail_carrier_route": "R006"
          },
          "owner_vesting_info": {
            "vesting_owner": "SINGLE WOMAN",
            "vesting_etal": "",
            "vesting_ownership_right": ""
          }
        },
        "subject_property": {
          "property_id": 29002737,
          "parsed_street_address": {
            "street_name": "PINEWALK",
            "direction_suffix": "N",
            "standardized_house_number": 3330,
            "street_suffix": "DR",
            "apartment_or_unit": "1613"
          },
          "situs_address": {
            "street_address": "3330 PINEWALK DR N #1613",
            "state": "FL",
            "city": "MARGATE",
            "county": "BROWARD",
            "zip9": "33063-9338",
            "apn": "48-41-23-BC-2950"
          }
        },
        "location_information": {
          "census_tract": "020204",
          "neighborhood_name": "CORAL KEY",
          "subdivision": "CORAL KEY CONDO",
          "municipality_township": "MARGATE",
          "latitude": 26.26596,
          "longitude": -80.228435,
          "school_district": "BROWARD",
          "legal_description": "CORAL KEY CONDO UNIT 1613 BLDG 16",
          "county_fips": 12011
        },
        "title_search_address_details": {
          "address_components": [
            { "long_name": "3330", "short_name": "3330", "types": ["street_number"] },
            { "long_name": "Pinewalk Drive North", "short_name": "Pinewalk Dr N", "types": ["route"] },
            { "long_name": "Margate", "short_name": "Margate", "types": ["locality", "political"] },
            { "long_name": "Broward County", "short_name": "Broward County", "types": ["administrative_area_level_2", "political"] },
            { "long_name": "Florida", "short_name": "FL", "types": ["administrative_area_level_1", "political"] },
            { "long_name": "United States", "short_name": "US", "types": ["country", "political"] },
            { "long_name": "33063", "short_name": "33063", "types": ["postal_code"] }
          ],
          "formatted_address": "3330 Pinewalk Drive North, Margate, FL, USA",
          "unit_number": "1613"
        }
      },
      "custom_form_data": [
        {
          "question": "What is your Company Business Number",
          "answer": "1234567890",
          "type": "short-text"
        }
      ]
    }
  },
  "user": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "email": "john.doe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "created_at": "2025-01-10T08:00:00.000Z",
    "updated_at": "2025-01-15T10:42:00.000Z"
  },
  "sender_user": {
    "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "email": "admin@example.com",
    "first_name": "Admin",
    "last_name": "User",
    "phone": "+1987654321",
    "created_at": "2024-12-01T09:00:00.000Z",
    "updated_at": "2025-01-15T10:30:00.000Z"
  },
  "resource_links": {
    "id_back": "https://s3.amazonaws.com/...",
    "secondary_id_front": "https://s3.amazonaws.com/...",
    "secondary_id_back": "https://s3.amazonaws.com/...",
    "pdf_summary": "https://s3.amazonaws.com/...",
    "selfie_front": "https://s3.amazonaws.com/...",
    "faceliveness": "https://s3.amazonaws.com/...",
    "tertiary_id_front": "https://s3.amazonaws.com/...",
    "tertiary_id_back": "https://s3.amazonaws.com/...",
    "selfie_right": "https://s3.amazonaws.com/...",
    "id_front": "https://s3.amazonaws.com/...",
    "Hold up 3 fingers": "https://s3.amazonaws.com/...",
    "selfie_left": "https://s3.amazonaws.com/...",
    "document_1": "https://s3.amazonaws.com/..."
  }
}

GET

sessions

{id}

Retrieve Session

curl --request GET \
  --url https://api.deepidv.com/v1/sessions/{id}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.deepidv.com/v1/sessions/{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.deepidv.com/v1/sessions/{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))

}

require 'uri'
require 'net/http'

url = URI("https://api.deepidv.com/v1/sessions/{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_body

{
  "session_record": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "organization_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "user_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "sender_user_id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "status": "SUBMITTED",
    "type": "session",
    "session_progress": "COMPLETED",
    "location": {
      "country": "Canada"
    },
    "workflow_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "bank_statement_request_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
    "workflow_steps": ["ID_VERIFICATION", "FACE_LIVENESS", "PEP_SANCTIONS"],
    "created_at": "2025-01-15T10:30:00.000Z",
    "updated_at": "2025-01-15T10:45:00.000Z",
    "submitted_at": "2025-01-15T10:42:00.000Z",
    "meta_data": {
      "applicantSubmissionIp": "192.168.1.1, 10.0.0.1",
      "applicantSubmissionDevice": "Mac",
      "applicantViewTime": "2025-01-15T10:35:00.000Z",
      "applicantSubmissionBrowser": "Safari",
      "applicantSubmissionLocation": "Chicago, United States",
      "applicantSubmissionLocationDetails": {
        "accuracyRadius": 500,
        "continent": "North America",
        "country": "United States",
        "countryIsoCode": "US",
        "latitude": 41.8483,
        "longitude": -87.6517,
        "subdivision": "Illinois",
        "timeZone": "America/Chicago"
      },
      "failureData": {
        "failedAttempts": 1,
        "attempts": [
          { "reason": "NO_FACE_DETECTED", "slot": "PRIMARY", "failedAt": "2025-01-15T10:37:00.000Z" }
        ]
      },
      "declinedData": {
        "declined": true,
        "score": 2,
        "declinedAt": "2025-01-15T10:43:00.000Z",
        "reason": {
          "code": "LOW_FACE_MATCH",
          "detail": "Face match confidence is low",
          "slot": "PRIMARY",
          "severity": "CRITICAL"
        }
      }
    },
    "uploads": {
      "id_front": true,
      "id_back": true,
      "secondary_id_front": true,
      "secondary_id_back": true,
      "tertiary_id_front": true,
      "tertiary_id_back": true,
      "selfie_front": true,
      "selfie_right": true,
      "selfie_left": true,
      "faceliveness": true,
      "hold_up_3_fingers": true,
      "pdf_summary": true
    },
    "analysis_data": {
      "created_at": "2025-01-15T10:43:00.000Z",
      "id_matches_selfie": true,
      "faceliveness_score": 99.49,
      "id_matches_face_capture": true,
      "id_matches_liveness": true,
      "id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.56, "sharpness": 38.90 },
            "bounding_box": { "height": 0.32, "left": 0.11, "top": 0.33, "width": 0.19 },
            "pose": { "pitch": 11.74, "yaw": 3.85, "roll": -2.84 },
            "landmarks": [
              { "x": 0.164, "y": 0.458, "type": "eyeLeft" },
              { "x": 0.248, "y": 0.449, "type": "eyeRight" },
              { "x": 0.215, "y": 0.507, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 91.22 }
          }
        ],
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.64 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.15 },
          { "type": "MIDDLE_NAME", "value": "", "confidence": 99.15 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 95.46 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.87 },
          { "type": "DATE_OF_ISSUE", "value": "2023/06/30", "confidence": 95.40 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 90.02 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 0.66 },
          { "type": "ADDRESS", "value": "123 MAIN ST", "confidence": 94.86 },
          { "type": "CITY_IN_ADDRESS", "value": "SPRINGFIELD IL", "confidence": 66.81 },
          { "type": "STATE_IN_ADDRESS", "value": "IL", "confidence": 47.99 },
          { "type": "CLASS", "value": "G", "confidence": 97.54 },
          { "type": "RESTRICTIONS", "value": "X", "confidence": 97.29 }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": true,
        "age_restriction_pass": true
      },
      "secondary_id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.30, "sharpness": 38.90 },
            "bounding_box": { "height": 0.30, "left": 0.12, "top": 0.35, "width": 0.18 },
            "pose": { "pitch": 11.98, "yaw": 3.80, "roll": -2.13 },
            "landmarks": [
              { "x": 0.174, "y": 0.466, "type": "eyeLeft" },
              { "x": 0.253, "y": 0.460, "type": "eyeRight" },
              { "x": 0.219, "y": 0.513, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 87.16 }
          }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": false,
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.63 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.17 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 94.95 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.64 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 94.87 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 90.14 }
        ],
        "age_restriction_pass": true
      },
      "tertiary_id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.39, "sharpness": 38.90 },
            "bounding_box": { "height": 0.30, "left": 0.14, "top": 0.36, "width": 0.18 },
            "pose": { "pitch": 11.39, "yaw": 3.27, "roll": -3.04 },
            "landmarks": [
              { "x": 0.191, "y": 0.479, "type": "eyeLeft" },
              { "x": 0.270, "y": 0.472, "type": "eyeRight" },
              { "x": 0.239, "y": 0.526, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 92.90 }
          }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": false,
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.60 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.15 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 95.75 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.78 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 92.32 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 90.11 }
        ],
        "age_restriction_pass": true
      },
      "pep_sanctions_data": {
        "peps": [
          {
            "name": "John Smith",
            "country": "United Kingdom",
            "score": 1,
            "id": "Q180589",
            "datasets": ["ann_pep_positions", "wd_peps"],
            "birth_date": "1964-06-19"
          },
          {
            "name": "Jane Smith",
            "country": "Unknown",
            "score": 0.776,
            "id": "Q19360548",
            "datasets": ["wd_peps", "ann_pep_positions"],
            "birth_date": "1923-06-23"
          }
        ],
        "sanctions": null,
        "both": null
      },
      "compare_faces_data": {
        "face_match_confidence": 99.92,
        "face_match_result": {
          "face": {
            "landmarks": [
              { "x": 0.164, "y": 0.458, "type": "eyeLeft" },
              { "x": 0.248, "y": 0.449, "type": "eyeRight" },
              { "x": 0.215, "y": 0.507, "type": "nose" }
            ],
            "confidence": 99.99,
            "quality": { "brightness": 97.56, "sharpness": 38.90 },
            "bounding_box": { "height": 0.32, "left": 0.11, "top": 0.33, "width": 0.19 },
            "pose": { "pitch": 11.74, "yaw": 3.85, "roll": -2.84 }
          },
          "similarity": 99.92
        }
      },
      "adverse_media_data": {
        "total_hits": 10,
        "news_exposures": {
          "violent_crime": {
            "category": "violent_crime",
            "hits": 2,
            "articles": [
              {
                "source": "serper",
                "headline": "Example headline about violent crime",
                "source_link": "https://example.com/article-1",
                "timestamp": "3 weeks ago"
              }
            ]
          },
          "terrorism": { "category": "terrorism", "hits": 0, "articles": [] },
          "regulatory": { "category": "regulatory", "hits": 0, "articles": [] },
          "financial_crime": { "category": "financial_crime", "hits": 0, "articles": [] },
          "political": { "category": "political", "hits": 0, "articles": [] },
          "uncategorized": {
            "category": "uncategorized",
            "hits": 6,
            "articles": [
              {
                "source": "serper",
                "headline": "Example uncategorized article headline",
                "source_link": "https://example.com/article-2",
                "timestamp": "Sep 14, 2025"
              }
            ]
          },
          "organized_crime": { "category": "organized_crime", "hits": 0, "articles": [] },
          "criminal_legal": {
            "category": "criminal_legal",
            "hits": 2,
            "articles": [
              {
                "source": "serper",
                "headline": "Example criminal legal article headline",
                "source_link": "https://example.com/article-3",
                "timestamp": "Sep 9, 2025"
              }
            ]
          }
        },
        "timestamp": "2025-01-15T10:43:16.338Z"
      },
      "selected_document_types": {
        "secondary": "passport",
        "tertiary": "pr_card",
        "primary": "drivers_license"
      },
      "document_risk_data": {
        "document_analysis": [
          {
            "expected_document_name": "Articles of Incorporation",
            "metadata": {
              "creator": "Microsoft\u00ae Word for Microsoft 365",
              "mod_date": "2022-04-14T03:02:41.000Z",
              "page_count": 1,
              "encrypted": false,
              "author": "John Doe",
              "producer": "Microsoft\u00ae Word for Microsoft 365",
              "creation_date": "2022-04-14T03:02:41.000Z",
              "title": null
            },
            "signals": [
              {
                "severity": "high",
                "weight": 45,
                "code": "DOCUMENT_TYPE_MISMATCH",
                "evidence": {
                  "mismatch_details": "The uploaded document does not match the expected document type 'Articles of Incorporation'.",
                  "detected_type": "Other",
                  "ai_confidence": 1,
                  "expected_type": "Articles of Incorporation"
                },
                "message": "Uploaded document does not match the expected document type"
              }
            ],
            "document_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901/a1b2c3d4-e5f6-7890-abcd-ef1234567890/1772386555165-pdf",
            "field_label": "document_1",
            "total_weight": 0,
            "max_possible_weight": 190,
            "ai_analysis": {
              "overall_assessment": "likely_fabricated",
              "claimed_dates": {
                "document_date": null,
                "statement_period": null,
                "transaction_dates": []
              },
              "content_analysis": {
                "expected_document_type": "Articles of Incorporation",
                "content_quality": "complete",
                "document_type": "Other",
                "issuing_entity": null
              },
              "document_type_mismatch_details": "The uploaded document does not match the expected document type.",
              "confidence": 1,
              "date_mismatch_details": null,
              "date_mismatch_detected": false,
              "document_type_mismatch": true,
              "reasoning": "The document provided does not match the expected 'Articles of Incorporation'. This represents a critical document type mismatch.",
              "suspicious_patterns": [
                {
                  "severity": "high",
                  "type": "Document Content Irrelevance",
                  "description": "The document content does not match 'Articles of Incorporation' as expected."
                }
              ],
              "risk_score": 95,
              "risk_indicators": [
                "Document type mismatch",
                "Irrelevant content submitted"
              ]
            },
            "risk_score": 95,
            "status_message": null,
            "status": "ok"
          }
        ],
        "analysis_timestamp": "2025-01-15T10:43:21.588Z",
        "documents_with_signals": 1,
        "overall_risk_score": 95,
        "documents_analyzed": 1
      },
      "title_search_data": {
        "last_market_sale_information": {
          "sale_type": "",
          "first_mortgage_amount": null,
          "sale_date": "2010-10-19T00:00:00",
          "sale_price": 38000,
          "deed_type": "WARRANTY DEED",
          "buyer_name": "SMITH,JOHN & JANE",
          "seller_name": "JOHNSON,ROBERT",
          "recording_date": "2010-12-15T00:00:00",
          "book_page": "47589.183",
          "current_through_date": "2026-02-17T00:00:00"
        },
        "owner_transfer_information": {
          "current_through_date": "2026-02-17T00:00:00",
          "sale_date": "2020-02-20T00:00:00",
          "recording_sale_date": "2021-05-07T00:00:00",
          "buyer_name": "SMITH JANE L",
          "sale_price": null,
          "deed_type": "QUIT CLAIM DEED",
          "seller_name": "SMITH JOHN S"
        },
        "owner_information": {
          "owner_names": "SMITH JANE L",
          "owner1_full_name": "SMITH JANE L",
          "owner2_full_name": "",
          "occupancy": "Absentee Owner",
          "owner_occupied_indicator": "N",
          "mailing_address": {
            "street_address": "1170 OAK CT",
            "city": "SPRINGFIELD",
            "state": "IL",
            "zip9": "62701-2804",
            "mail_carrier_route": "R006"
          },
          "owner_vesting_info": {
            "vesting_owner": "SINGLE WOMAN",
            "vesting_etal": "",
            "vesting_ownership_right": ""
          }
        },
        "subject_property": {
          "property_id": 29002737,
          "parsed_street_address": {
            "street_name": "PINEWALK",
            "direction_suffix": "N",
            "standardized_house_number": 3330,
            "street_suffix": "DR",
            "apartment_or_unit": "1613"
          },
          "situs_address": {
            "street_address": "3330 PINEWALK DR N #1613",
            "state": "FL",
            "city": "MARGATE",
            "county": "BROWARD",
            "zip9": "33063-9338",
            "apn": "48-41-23-BC-2950"
          }
        },
        "location_information": {
          "census_tract": "020204",
          "neighborhood_name": "CORAL KEY",
          "subdivision": "CORAL KEY CONDO",
          "municipality_township": "MARGATE",
          "latitude": 26.26596,
          "longitude": -80.228435,
          "school_district": "BROWARD",
          "legal_description": "CORAL KEY CONDO UNIT 1613 BLDG 16",
          "county_fips": 12011
        },
        "title_search_address_details": {
          "address_components": [
            { "long_name": "3330", "short_name": "3330", "types": ["street_number"] },
            { "long_name": "Pinewalk Drive North", "short_name": "Pinewalk Dr N", "types": ["route"] },
            { "long_name": "Margate", "short_name": "Margate", "types": ["locality", "political"] },
            { "long_name": "Broward County", "short_name": "Broward County", "types": ["administrative_area_level_2", "political"] },
            { "long_name": "Florida", "short_name": "FL", "types": ["administrative_area_level_1", "political"] },
            { "long_name": "United States", "short_name": "US", "types": ["country", "political"] },
            { "long_name": "33063", "short_name": "33063", "types": ["postal_code"] }
          ],
          "formatted_address": "3330 Pinewalk Drive North, Margate, FL, USA",
          "unit_number": "1613"
        }
      },
      "custom_form_data": [
        {
          "question": "What is your Company Business Number",
          "answer": "1234567890",
          "type": "short-text"
        }
      ]
    }
  },
  "user": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "email": "john.doe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "created_at": "2025-01-10T08:00:00.000Z",
    "updated_at": "2025-01-15T10:42:00.000Z"
  },
  "sender_user": {
    "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "email": "admin@example.com",
    "first_name": "Admin",
    "last_name": "User",
    "phone": "+1987654321",
    "created_at": "2024-12-01T09:00:00.000Z",
    "updated_at": "2025-01-15T10:30:00.000Z"
  },
  "resource_links": {
    "id_back": "https://s3.amazonaws.com/...",
    "secondary_id_front": "https://s3.amazonaws.com/...",
    "secondary_id_back": "https://s3.amazonaws.com/...",
    "pdf_summary": "https://s3.amazonaws.com/...",
    "selfie_front": "https://s3.amazonaws.com/...",
    "faceliveness": "https://s3.amazonaws.com/...",
    "tertiary_id_front": "https://s3.amazonaws.com/...",
    "tertiary_id_back": "https://s3.amazonaws.com/...",
    "selfie_right": "https://s3.amazonaws.com/...",
    "id_front": "https://s3.amazonaws.com/...",
    "Hold up 3 fingers": "https://s3.amazonaws.com/...",
    "selfie_left": "https://s3.amazonaws.com/...",
    "document_1": "https://s3.amazonaws.com/..."
  }
}

GET /v1/sessions/{id}

Retrieves the full details of a single verification session by its session ID, including analysis results and presigned URLs for uploaded documents.

Request

Headers

Header	Required	Description
`x-api-key`	Yes	Your API key

Path parameters

Parameter	Type	Required	Description
`id`	string	Yes	The session ID (returned as `id` when the session was created)

Example request

curl -X GET https://api.deepidv.com/v1/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.deepidv.com/v1/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  }
);

const data = await response.json();

import requests

response = requests.get(
    "https://api.deepidv.com/v1/sessions/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    headers={"x-api-key": "YOUR_API_KEY"},
)

Response

200 — Success

Top-level response

Field	Type	Description
`session_record`	object	The full session object
`resource_links`	object	Presigned S3 URLs for uploaded documents and images (valid for a limited time)
`user`	object	The applicant’s user profile (omitted if the user record is unavailable)
`sender_user`	object	The user who created/sent the session (omitted if the user record is unavailable)

Session object

Field	Type	Description
`id`	string	Unique session identifier
`organization_id`	string	Organization that owns this session
`user_id`	string	User ID of the applicant
`sender_user_id`	string	User ID of the person who created the session
`external_id`	string	Your external reference ID (if provided)
`permalink_id`	string	Permalink ID (if applicable)
`location`	object	Applicant’s location (if captured), e.g. `{ "country": "Canada" }`
`status`	string	`PENDING`, `SUBMITTED`, `VERIFIED`, `REJECTED`, `VOIDED`, `EXPIRED`, or `FAILED`
`type`	string	`session` (workflow-based), `verification` (standalone), `credit-application` (ClearView), `silent-screening` (silent screening), or `deep-doc` (document transfer)
`session_progress`	string	`PENDING`, `STARTED`, or `COMPLETED`
`created_at`	string	ISO 8601 timestamp of session creation
`updated_at`	string	ISO 8601 timestamp of last update
`submitted_at`	string	ISO 8601 timestamp when the applicant submitted
`workflow_id`	string	Workflow ID used for this session
`workflow_steps`	string[]	List of workflow step IDs (e.g. `ID_VERIFICATION`, `FACE_LIVENESS`)
`expires_at`	string	ISO 8601 timestamp when the session will auto-expire (if configured)
`bank_statement_request_id`	string	Associated bank statement request ID
`deep_sign_id`	string	Associated e-sign ID
`face_liveness_session_id`	string	Face liveness session ID
`uploads`	object	Boolean flags for each uploaded document type
`analysis_data`	object	Verification analysis results (see below)
`meta_data`	object	Applicant submission metadata

`meta_data` object

Field	Type	Description
`applicantSubmissionIp`	string	IP address at time of submission
`applicantSubmissionDevice`	string	Device used for submission
`applicantViewTime`	string	ISO 8601 timestamp when the applicant viewed the verification page
`applicantSubmissionBrowser`	string	Browser used for submission
`applicantSubmissionLocation`	string	Human-readable submission location (typically `"City, Country"` when available)
`applicantSubmissionLocationDetails`	object	Structured geo lookup of the submission IP (see below)
`failureData`	object	Auto-failure attempt history (only present once at least one failed attempt has been recorded — see below)
`declinedData`	object	Automated decline decision (only present when the session was auto-declined by AI identity verification — see below)

`applicantSubmissionLocationDetails` object

Derived from a geo lookup of the submission IP. All fields are optional — any field may be absent if the lookup could not resolve it.

Field	Type	Description
`accuracyRadius`	number	Radius (km) of confidence around the resolved coordinates
`city`	string	City name
`continent`	string	Continent name
`country`	string	Country name
`countryIsoCode`	string	ISO 3166-1 alpha-2 country code
`latitude`	number	Latitude of the resolved location
`longitude`	number	Longitude of the resolved location
`postalCode`	string	Postal/ZIP code
`subdivision`	string	State, province, or other primary subdivision
`timeZone`	string	IANA timezone identifier (e.g. `"America/Chicago"`)

`failureData` object

Tracks per-attempt failures when the workflow has auto-session-failure enabled. Absent until the first failed attempt is recorded. When failedAttempts reaches the workflow’s configured maxAttempts, the session’s top-level status flips to FAILED and session_progress to COMPLETED.

Field	Type	Description
`failedAttempts`	number	Count of failed attempts recorded for this session
`attempts`	object[]	Ordered list of attempts (oldest first) — one entry per recorded failure

Each entry in attempts has the following shape:

Field	Type	Description
`reason`	string	The check that failed. One of `NO_FACE_DETECTED`, `OCR_NAME_MISSING`, `DOC_TYPE_NOT_ALLOWED`, `ID_TYPE_UNRECOGNIZED`, `ID_TYPE_LOW_CONFIDENCE`, `FACE_MISMATCH`, or `LIVENESS_ID_MISMATCH`. The two `ID_TYPE_*` values are emitted only when the workflow’s ID confidence threshold is enabled (driver’s licence / passport): `ID_TYPE_UNRECOGNIZED` when the document type could not be read, and `ID_TYPE_LOW_CONFIDENCE` when it was read below the configured confidence. `FACE_MISMATCH` is the selfie↔ID face-match failure; `LIVENESS_ID_MISMATCH` is the Face Liveness↔ID identity-binding failure. New values may be added over time — consumers should treat this as an open string.
`slot`	string \| null	Which ID slot the failure applies to: `PRIMARY`, `SECONDARY`, `TERTIARY`, or `null` when the failure is not slot-specific.
`failedAt`	string	ISO 8601 timestamp of when the attempt was recorded

"failureData": {
  "failedAttempts": 3,
  "attempts": [
    { "reason": "NO_FACE_DETECTED", "slot": "PRIMARY", "failedAt": "2026-05-26T15:30:00.000Z" },
    { "reason": "OCR_NAME_MISSING", "slot": "SECONDARY", "failedAt": "2026-05-26T15:32:14.000Z" },
    { "reason": "ID_TYPE_LOW_CONFIDENCE", "slot": "PRIMARY", "failedAt": "2026-05-26T15:34:02.000Z" }
  ]
}

`declinedData` object

Present only when the session was automatically declined by deepidv’s AI identity verification. It records the single decisive reason for the decline. Absent for sessions that passed, are awaiting manual review, or were auto-failed via attempt limits (see failureData — that is a separate, attempt-based mechanism). The full scoring breakdown that drove the decision remains available under analysis_data.

Field	Type	Description
`declined`	boolean	Always `true` when this object is present
`score`	number \| null	Normalized verification score (0–10) behind the decision. `0` for a deterministic ID-type decline; `null` when a score does not apply
`declinedAt`	string	ISO 8601 timestamp of the decline decision
`reason`	object	The single decisive decline reason (see below)

The reason object:

Field	Type	Description
`code`	string	Machine-readable reason code (see table below). New values may be added over time — consumers should treat this as an open string.
`detail`	string	Short, human-readable description suitable for display
`slot`	string \| null	Which ID slot the reason applies to: `PRIMARY`, `SECONDARY`, `TERTIARY`, or `null` when the reason is not slot-specific
`severity`	string	`LOW`, `MEDIUM`, `HIGH`, or `CRITICAL`

Reason codes:

`code`	Severity	Meaning
`ID_TYPE_UNRECOGNIZED`	`CRITICAL`	The document type could not be read from the ID
`ID_TYPE_LOW_CONFIDENCE`	`CRITICAL`	The document type was read below the configured confidence threshold
`DOC_TYPE_NOT_ALLOWED`	`CRITICAL`	The detected document type is not permitted for the workflow / does not match the selected type
`LOW_FACE_MATCH`	`CRITICAL`	Face-match confidence between the selfie and the ID photo was too low
`FACE_SELFIE_MISMATCH`	`CRITICAL`	The face on the ID did not match the selfie
`LOW_LIVENESS`	`CRITICAL`	The liveness check did not pass
`DOC_TYPE_MISMATCH`	`CRITICAL`	The submitted document type differed from the type the applicant selected
`LOW_SCORE`	`HIGH`	The overall verification score fell below the auto-approval threshold

"declinedData": {
  "declined": true,
  "score": 2,
  "declinedAt": "2025-01-15T10:43:00.000Z",
  "reason": {
    "code": "LOW_FACE_MATCH",
    "detail": "Face match confidence is low",
    "slot": "PRIMARY",
    "severity": "CRITICAL"
  }
}

`analysis_data` object

Field	Type	Description
`created_at`	string	When analysis was performed
`id_analysis_data`	object	Primary ID document analysis
`id_matches_selfie`	boolean	Rollup identity result — logical AND of `id_matches_face_capture` and `id_matches_liveness` (whichever ran). `false` if either present check failed
`faceliveness_score`	number	Liveness confidence score (0–100)
`id_matches_face_capture`	boolean	Whether the face/selfie capture matched the ID portrait. `null` if not evaluated
`id_matches_liveness`	boolean	Whether the Face Liveness capture matched the ID portrait (Face Liveness workflows only). `null` if not evaluated
`compare_faces_data`	object	Face comparison results
`pep_sanctions_data`	object	PEP & sanctions screening results
`adverse_media_data`	object	Adverse media screening results
`secondary_id_analysis_data`	object	Secondary ID document analysis
`tertiary_id_analysis_data`	object	Tertiary ID document analysis
`selected_document_types`	object	Document types selected by applicant
`document_risk_data`	object	Document fraud/risk analysis
`title_search_data`	object	Property title search results
`custom_form_data`	array	Custom form question/answer entries
`ip_jurisdiction_data`	object	iGaming IP jurisdiction result (see iGaming check data)
`vpn_detection_data`	object	iGaming VPN / anonymizer result
`injection_detection_data`	object	iGaming injection detection result
`anti_cheat_data`	object	iGaming anti-cheat result — richer than the redacted API response
`phone_checks`	object	Carrier intelligence results (see Carrier intelligence data)

iGaming check data

Each iGaming check writes its result here when it runs, whether as a workflow step or a standalone POST /v1/igaming/* call. Keys inside these objects are snake_case in this response (the live check responses use camelCase evidence keys).

Object	Fields
`ip_jurisdiction_data`	`verdict`, `action`, `evidence` (`location_details`, `matched_rule`, datacenter-feed fields), `settings_snapshot`, `checked_ip`, `timestamp`, `escalation` (only on step-up)
`vpn_detection_data`	`verdict`, `action`, `evidence` (`asn`, `asn_org`, `matched`, `type`, `confidence`, `feed_version`, `stale`), `settings_snapshot`, `checked_ip`, `timestamp`, `escalation` (only on step-up)
`injection_detection_data`	`verdict`, `action`, `confidence`, `evidence` (`hard_fail`, `signals`, `hard_signals`, or `confidence`, `media_source_score`, `frame_timing_score`, `reason`, `automation_signals`), `timestamp`
`anti_cheat_data`	`verdict`, `action`, `dedup_action`, `matched_session_id`, `similarity`, `face_id`, `threshold`, `links[]` (`session_id`, `score`, `matched_signals`), `multi_account`, `multi_account_action`, `link_sensitivity`, `timestamp`. On `SELF_EXCLUSION`: `verdict`, `action`, `reason` (`identity` or `face`), `matched_session_id`, `threshold`, `timestamp`

A check whose action was block also sets the session’s top-level status to FAILED.

Carrier intelligence data

phone_checks holds the results of the carrier checks, whether they ran as passive workflow steps at session creation or were attached to the session by a standalone call with sessionId (Phone Trust, Carrier Age Gate, Phone Ownership). Keys are snake_case in this response.

Object	Fields
`phone_checks.trust`	`status_message`, `sim_swapped_risk` (`NO_DATA` / `LOW_RISK` / `MEDIUM_RISK` / `HIGH_RISK`), `sim_changed_date`, `forwarding_risk` (`NO_DATA` / `NO_RISK` / `HIGH_RISK`), `sensitivity`, `action` (`flag` or `step_up`), `tripped`, `trip_reasons[]`, `checked_at`, `correlation_id`. `sms_verification` is present when the applicant-facing SMS code step ran
`phone_checks.age_gate`	`status_message`, `age_verified` (`VERIFIED` / `NOT_VERIFIED` / `NO_DATA`), `carrier_threshold`, `required_age`, `outcome` (`PASS` / `FAIL` / `NO_DATA`), `action`, `tripped`, `trip_reasons[]`, `checked_at`, `correlation_id`
`phone_checks.ownership`	`status_message`, `name_score`, `first_name_score`, `last_name_score`, `dob_score`, `address_score`, `outcome` (`MATCH` / `NO_MATCH` / `NO_DATA`), `strictness`, `threshold`, `action`, `challenge_source` (`invite-name` for the passive step, `api` for a standalone call), `tripped`, `trip_reasons[]`, `checked_at`, `correlation_id`

Carrier checks never change the session’s top-level status on their own.

`id_analysis_data` object

Field	Type	Description
`detect_face_data`	array	Face detection results from the ID document
`id_extracted_text`	array	Text fields extracted from the ID (name, DOB, ID number, etc.)
`expiry_date_pass`	boolean	Whether the ID has not expired
`valid_state_pass`	boolean	Whether the ID state/province is valid
`age_restriction_pass`	boolean	Whether the applicant meets age requirements

`pep_sanctions_data` object

Field	Type	Description
`peps`	array \| null	Matches against Politically Exposed Persons lists
`sanctions`	array \| null	Matches against sanctions lists
`both`	array \| null	Matches appearing on both PEP and sanctions lists

Each match item contains:

Field	Type	Description
`name`	string	Matched name
`country`	string	Country associated with the match
`score`	number	Match confidence score
`id`	string	Record ID in the source dataset
`datasets`	string[]	Source datasets for this match
`birth_date`	string	Date of birth (if available)

`compare_faces_data` object

Field	Type	Description
`face_match_confidence`	number	Overall face match confidence (0–100)
`face_match_result`	object	Detailed comparison result including `similarity` score and `face` details

`document_risk_data` object

Field	Type	Description
`documents_analyzed`	number	Number of documents analyzed
`documents_with_signals`	number	Number of documents with risk signals
`overall_risk_score`	number	Aggregate risk score
`analysis_timestamp`	string	When the risk analysis was performed
`document_analysis`	array	Per-document analysis with risk signals, AI analysis, and metadata

`user` / `sender_user` object

Both user (the applicant) and sender_user (the session creator) share the same shape:

Field	Type	Description
`id`	string	Unique user identifier
`email`	string	User’s email address
`first_name`	string	User’s first name
`last_name`	string	User’s last name
`phone`	string	User’s phone number
`created_at`	string	ISO 8601 timestamp of user creation
`updated_at`	string	ISO 8601 timestamp of last update

Error responses

Status	Description
`400 Bad Request`	Invalid session ID format
`401 Unauthorized`	Missing or invalid API key
`403 Forbidden`	Session belongs to a different organization
`404 Not Found`	Session ID does not exist
`429 Too Many Requests`	Rate limit exceeded

{
  "session_record": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "organization_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "user_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "sender_user_id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "status": "SUBMITTED",
    "type": "session",
    "session_progress": "COMPLETED",
    "location": {
      "country": "Canada"
    },
    "workflow_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "bank_statement_request_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
    "workflow_steps": ["ID_VERIFICATION", "FACE_LIVENESS", "PEP_SANCTIONS"],
    "created_at": "2025-01-15T10:30:00.000Z",
    "updated_at": "2025-01-15T10:45:00.000Z",
    "submitted_at": "2025-01-15T10:42:00.000Z",
    "meta_data": {
      "applicantSubmissionIp": "192.168.1.1, 10.0.0.1",
      "applicantSubmissionDevice": "Mac",
      "applicantViewTime": "2025-01-15T10:35:00.000Z",
      "applicantSubmissionBrowser": "Safari",
      "applicantSubmissionLocation": "Chicago, United States",
      "applicantSubmissionLocationDetails": {
        "accuracyRadius": 500,
        "continent": "North America",
        "country": "United States",
        "countryIsoCode": "US",
        "latitude": 41.8483,
        "longitude": -87.6517,
        "subdivision": "Illinois",
        "timeZone": "America/Chicago"
      },
      "failureData": {
        "failedAttempts": 1,
        "attempts": [
          { "reason": "NO_FACE_DETECTED", "slot": "PRIMARY", "failedAt": "2025-01-15T10:37:00.000Z" }
        ]
      },
      "declinedData": {
        "declined": true,
        "score": 2,
        "declinedAt": "2025-01-15T10:43:00.000Z",
        "reason": {
          "code": "LOW_FACE_MATCH",
          "detail": "Face match confidence is low",
          "slot": "PRIMARY",
          "severity": "CRITICAL"
        }
      }
    },
    "uploads": {
      "id_front": true,
      "id_back": true,
      "secondary_id_front": true,
      "secondary_id_back": true,
      "tertiary_id_front": true,
      "tertiary_id_back": true,
      "selfie_front": true,
      "selfie_right": true,
      "selfie_left": true,
      "faceliveness": true,
      "hold_up_3_fingers": true,
      "pdf_summary": true
    },
    "analysis_data": {
      "created_at": "2025-01-15T10:43:00.000Z",
      "id_matches_selfie": true,
      "faceliveness_score": 99.49,
      "id_matches_face_capture": true,
      "id_matches_liveness": true,
      "id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.56, "sharpness": 38.90 },
            "bounding_box": { "height": 0.32, "left": 0.11, "top": 0.33, "width": 0.19 },
            "pose": { "pitch": 11.74, "yaw": 3.85, "roll": -2.84 },
            "landmarks": [
              { "x": 0.164, "y": 0.458, "type": "eyeLeft" },
              { "x": 0.248, "y": 0.449, "type": "eyeRight" },
              { "x": 0.215, "y": 0.507, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 91.22 }
          }
        ],
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.64 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.15 },
          { "type": "MIDDLE_NAME", "value": "", "confidence": 99.15 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 95.46 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.87 },
          { "type": "DATE_OF_ISSUE", "value": "2023/06/30", "confidence": 95.40 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 90.02 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 0.66 },
          { "type": "ADDRESS", "value": "123 MAIN ST", "confidence": 94.86 },
          { "type": "CITY_IN_ADDRESS", "value": "SPRINGFIELD IL", "confidence": 66.81 },
          { "type": "STATE_IN_ADDRESS", "value": "IL", "confidence": 47.99 },
          { "type": "CLASS", "value": "G", "confidence": 97.54 },
          { "type": "RESTRICTIONS", "value": "X", "confidence": 97.29 }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": true,
        "age_restriction_pass": true
      },
      "secondary_id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.30, "sharpness": 38.90 },
            "bounding_box": { "height": 0.30, "left": 0.12, "top": 0.35, "width": 0.18 },
            "pose": { "pitch": 11.98, "yaw": 3.80, "roll": -2.13 },
            "landmarks": [
              { "x": 0.174, "y": 0.466, "type": "eyeLeft" },
              { "x": 0.253, "y": 0.460, "type": "eyeRight" },
              { "x": 0.219, "y": 0.513, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 87.16 }
          }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": false,
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.63 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.17 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 94.95 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.64 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 94.87 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 90.14 }
        ],
        "age_restriction_pass": true
      },
      "tertiary_id_analysis_data": {
        "detect_face_data": [
          {
            "confidence": 99.99,
            "age_range": { "high": 35, "low": 28 },
            "quality": { "brightness": 97.39, "sharpness": 38.90 },
            "bounding_box": { "height": 0.30, "left": 0.14, "top": 0.36, "width": 0.18 },
            "pose": { "pitch": 11.39, "yaw": 3.27, "roll": -3.04 },
            "landmarks": [
              { "x": 0.191, "y": 0.479, "type": "eyeLeft" },
              { "x": 0.270, "y": 0.472, "type": "eyeRight" },
              { "x": 0.239, "y": 0.526, "type": "nose" }
            ],
            "gender": { "value": "Male", "confidence": 92.90 }
          }
        ],
        "expiry_date_pass": true,
        "valid_state_pass": false,
        "id_extracted_text": [
          { "type": "FIRST_NAME", "value": "JOHN", "confidence": 97.60 },
          { "type": "LAST_NAME", "value": "DOE", "confidence": 97.15 },
          { "type": "DATE_OF_BIRTH", "value": "1990/05/15", "confidence": 95.75 },
          { "type": "EXPIRATION_DATE", "value": "2028/05/19", "confidence": 95.78 },
          { "type": "ID_TYPE", "value": "DRIVER LICENSE FRONT", "confidence": 92.32 },
          { "type": "DOCUMENT_NUMBER", "value": "D123456789", "confidence": 90.11 }
        ],
        "age_restriction_pass": true
      },
      "pep_sanctions_data": {
        "peps": [
          {
            "name": "John Smith",
            "country": "United Kingdom",
            "score": 1,
            "id": "Q180589",
            "datasets": ["ann_pep_positions", "wd_peps"],
            "birth_date": "1964-06-19"
          },
          {
            "name": "Jane Smith",
            "country": "Unknown",
            "score": 0.776,
            "id": "Q19360548",
            "datasets": ["wd_peps", "ann_pep_positions"],
            "birth_date": "1923-06-23"
          }
        ],
        "sanctions": null,
        "both": null
      },
      "compare_faces_data": {
        "face_match_confidence": 99.92,
        "face_match_result": {
          "face": {
            "landmarks": [
              { "x": 0.164, "y": 0.458, "type": "eyeLeft" },
              { "x": 0.248, "y": 0.449, "type": "eyeRight" },
              { "x": 0.215, "y": 0.507, "type": "nose" }
            ],
            "confidence": 99.99,
            "quality": { "brightness": 97.56, "sharpness": 38.90 },
            "bounding_box": { "height": 0.32, "left": 0.11, "top": 0.33, "width": 0.19 },
            "pose": { "pitch": 11.74, "yaw": 3.85, "roll": -2.84 }
          },
          "similarity": 99.92
        }
      },
      "adverse_media_data": {
        "total_hits": 10,
        "news_exposures": {
          "violent_crime": {
            "category": "violent_crime",
            "hits": 2,
            "articles": [
              {
                "source": "serper",
                "headline": "Example headline about violent crime",
                "source_link": "https://example.com/article-1",
                "timestamp": "3 weeks ago"
              }
            ]
          },
          "terrorism": { "category": "terrorism", "hits": 0, "articles": [] },
          "regulatory": { "category": "regulatory", "hits": 0, "articles": [] },
          "financial_crime": { "category": "financial_crime", "hits": 0, "articles": [] },
          "political": { "category": "political", "hits": 0, "articles": [] },
          "uncategorized": {
            "category": "uncategorized",
            "hits": 6,
            "articles": [
              {
                "source": "serper",
                "headline": "Example uncategorized article headline",
                "source_link": "https://example.com/article-2",
                "timestamp": "Sep 14, 2025"
              }
            ]
          },
          "organized_crime": { "category": "organized_crime", "hits": 0, "articles": [] },
          "criminal_legal": {
            "category": "criminal_legal",
            "hits": 2,
            "articles": [
              {
                "source": "serper",
                "headline": "Example criminal legal article headline",
                "source_link": "https://example.com/article-3",
                "timestamp": "Sep 9, 2025"
              }
            ]
          }
        },
        "timestamp": "2025-01-15T10:43:16.338Z"
      },
      "selected_document_types": {
        "secondary": "passport",
        "tertiary": "pr_card",
        "primary": "drivers_license"
      },
      "document_risk_data": {
        "document_analysis": [
          {
            "expected_document_name": "Articles of Incorporation",
            "metadata": {
              "creator": "Microsoft\u00ae Word for Microsoft 365",
              "mod_date": "2022-04-14T03:02:41.000Z",
              "page_count": 1,
              "encrypted": false,
              "author": "John Doe",
              "producer": "Microsoft\u00ae Word for Microsoft 365",
              "creation_date": "2022-04-14T03:02:41.000Z",
              "title": null
            },
            "signals": [
              {
                "severity": "high",
                "weight": 45,
                "code": "DOCUMENT_TYPE_MISMATCH",
                "evidence": {
                  "mismatch_details": "The uploaded document does not match the expected document type 'Articles of Incorporation'.",
                  "detected_type": "Other",
                  "ai_confidence": 1,
                  "expected_type": "Articles of Incorporation"
                },
                "message": "Uploaded document does not match the expected document type"
              }
            ],
            "document_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901/a1b2c3d4-e5f6-7890-abcd-ef1234567890/1772386555165-pdf",
            "field_label": "document_1",
            "total_weight": 0,
            "max_possible_weight": 190,
            "ai_analysis": {
              "overall_assessment": "likely_fabricated",
              "claimed_dates": {
                "document_date": null,
                "statement_period": null,
                "transaction_dates": []
              },
              "content_analysis": {
                "expected_document_type": "Articles of Incorporation",
                "content_quality": "complete",
                "document_type": "Other",
                "issuing_entity": null
              },
              "document_type_mismatch_details": "The uploaded document does not match the expected document type.",
              "confidence": 1,
              "date_mismatch_details": null,
              "date_mismatch_detected": false,
              "document_type_mismatch": true,
              "reasoning": "The document provided does not match the expected 'Articles of Incorporation'. This represents a critical document type mismatch.",
              "suspicious_patterns": [
                {
                  "severity": "high",
                  "type": "Document Content Irrelevance",
                  "description": "The document content does not match 'Articles of Incorporation' as expected."
                }
              ],
              "risk_score": 95,
              "risk_indicators": [
                "Document type mismatch",
                "Irrelevant content submitted"
              ]
            },
            "risk_score": 95,
            "status_message": null,
            "status": "ok"
          }
        ],
        "analysis_timestamp": "2025-01-15T10:43:21.588Z",
        "documents_with_signals": 1,
        "overall_risk_score": 95,
        "documents_analyzed": 1
      },
      "title_search_data": {
        "last_market_sale_information": {
          "sale_type": "",
          "first_mortgage_amount": null,
          "sale_date": "2010-10-19T00:00:00",
          "sale_price": 38000,
          "deed_type": "WARRANTY DEED",
          "buyer_name": "SMITH,JOHN & JANE",
          "seller_name": "JOHNSON,ROBERT",
          "recording_date": "2010-12-15T00:00:00",
          "book_page": "47589.183",
          "current_through_date": "2026-02-17T00:00:00"
        },
        "owner_transfer_information": {
          "current_through_date": "2026-02-17T00:00:00",
          "sale_date": "2020-02-20T00:00:00",
          "recording_sale_date": "2021-05-07T00:00:00",
          "buyer_name": "SMITH JANE L",
          "sale_price": null,
          "deed_type": "QUIT CLAIM DEED",
          "seller_name": "SMITH JOHN S"
        },
        "owner_information": {
          "owner_names": "SMITH JANE L",
          "owner1_full_name": "SMITH JANE L",
          "owner2_full_name": "",
          "occupancy": "Absentee Owner",
          "owner_occupied_indicator": "N",
          "mailing_address": {
            "street_address": "1170 OAK CT",
            "city": "SPRINGFIELD",
            "state": "IL",
            "zip9": "62701-2804",
            "mail_carrier_route": "R006"
          },
          "owner_vesting_info": {
            "vesting_owner": "SINGLE WOMAN",
            "vesting_etal": "",
            "vesting_ownership_right": ""
          }
        },
        "subject_property": {
          "property_id": 29002737,
          "parsed_street_address": {
            "street_name": "PINEWALK",
            "direction_suffix": "N",
            "standardized_house_number": 3330,
            "street_suffix": "DR",
            "apartment_or_unit": "1613"
          },
          "situs_address": {
            "street_address": "3330 PINEWALK DR N #1613",
            "state": "FL",
            "city": "MARGATE",
            "county": "BROWARD",
            "zip9": "33063-9338",
            "apn": "48-41-23-BC-2950"
          }
        },
        "location_information": {
          "census_tract": "020204",
          "neighborhood_name": "CORAL KEY",
          "subdivision": "CORAL KEY CONDO",
          "municipality_township": "MARGATE",
          "latitude": 26.26596,
          "longitude": -80.228435,
          "school_district": "BROWARD",
          "legal_description": "CORAL KEY CONDO UNIT 1613 BLDG 16",
          "county_fips": 12011
        },
        "title_search_address_details": {
          "address_components": [
            { "long_name": "3330", "short_name": "3330", "types": ["street_number"] },
            { "long_name": "Pinewalk Drive North", "short_name": "Pinewalk Dr N", "types": ["route"] },
            { "long_name": "Margate", "short_name": "Margate", "types": ["locality", "political"] },
            { "long_name": "Broward County", "short_name": "Broward County", "types": ["administrative_area_level_2", "political"] },
            { "long_name": "Florida", "short_name": "FL", "types": ["administrative_area_level_1", "political"] },
            { "long_name": "United States", "short_name": "US", "types": ["country", "political"] },
            { "long_name": "33063", "short_name": "33063", "types": ["postal_code"] }
          ],
          "formatted_address": "3330 Pinewalk Drive North, Margate, FL, USA",
          "unit_number": "1613"
        }
      },
      "custom_form_data": [
        {
          "question": "What is your Company Business Number",
          "answer": "1234567890",
          "type": "short-text"
        }
      ]
    }
  },
  "user": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "email": "john.doe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "created_at": "2025-01-10T08:00:00.000Z",
    "updated_at": "2025-01-15T10:42:00.000Z"
  },
  "sender_user": {
    "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "email": "admin@example.com",
    "first_name": "Admin",
    "last_name": "User",
    "phone": "+1987654321",
    "created_at": "2024-12-01T09:00:00.000Z",
    "updated_at": "2025-01-15T10:30:00.000Z"
  },
  "resource_links": {
    "id_back": "https://s3.amazonaws.com/...",
    "secondary_id_front": "https://s3.amazonaws.com/...",
    "secondary_id_back": "https://s3.amazonaws.com/...",
    "pdf_summary": "https://s3.amazonaws.com/...",
    "selfie_front": "https://s3.amazonaws.com/...",
    "faceliveness": "https://s3.amazonaws.com/...",
    "tertiary_id_front": "https://s3.amazonaws.com/...",
    "tertiary_id_back": "https://s3.amazonaws.com/...",
    "selfie_right": "https://s3.amazonaws.com/...",
    "id_front": "https://s3.amazonaws.com/...",
    "Hold up 3 fingers": "https://s3.amazonaws.com/...",
    "selfie_left": "https://s3.amazonaws.com/...",
    "document_1": "https://s3.amazonaws.com/..."
  }
}

Specifications

Sessions

Credit Check

Financial

Management API

Workflow Runner

Silent Screening

AML

Carrier Intelligence

Async Jobs

Server-to-Server

iGaming Checks

iGaming Self-Exclusion & Management

Sandbox

Retrieve Session

Request

Headers

Path parameters

Example request

Response

200 — Success

Top-level response

Session object

`meta_data` object

`applicantSubmissionLocationDetails` object

`failureData` object

`declinedData` object

`analysis_data` object

iGaming check data

Carrier intelligence data

`id_analysis_data` object

`pep_sanctions_data` object

`compare_faces_data` object

`document_risk_data` object

`user` / `sender_user` object

Error responses

​Request

​Headers

​Path parameters

​Example request

​Response

​200 — Success

​Top-level response

​Session object

​meta_data object

​applicantSubmissionLocationDetails object

​failureData object

​declinedData object

​analysis_data object

​iGaming check data

​Carrier intelligence data

​id_analysis_data object

​pep_sanctions_data object

​compare_faces_data object

​document_risk_data object

​user / sender_user object

​Error responses

Request

Headers

Path parameters

Example request

Response

200 — Success

Top-level response

Session object

`meta_data` object

`applicantSubmissionLocationDetails` object

`failureData` object

`declinedData` object

`analysis_data` object

iGaming check data

Carrier intelligence data

`id_analysis_data` object

`pep_sanctions_data` object

`compare_faces_data` object

`document_risk_data` object

`user` / `sender_user` object

Error responses