Skip to main content
GET
/
v2
/
verification
/
crime-check
Get Crime Check Report
curl --request GET \
  --url https://bgv.konnectnxt.com/api/v2/verification/crime-check/ \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "code": 200,
  "message": "Operation completed successfully",
  "data": {
    "status": "completed",
    "request_id": "2771138874513",
    "risk_assessment": {
      "risk_type": "Low Risk",
      "risk_summary": "No criminal records found for the subject.",
      "number_of_cases": 0
    },
    "download_link": "https://crime.getupforchange.com/api/v3/downloadReport/2771138874513/token123",
    "cases": []
  },
  "credits_used": 0,
  "credits_remaining": 985101.5
}

​
Overview

Fetches the crime check verification report for a previously initiated request. This endpoint does not consume credits.

​
Report Status

StatusHTTP CodeDescription
Completed200Report is ready with full details
In Progress202Report is still being processed, try again later
Failed400Verification failed or encountered an error
If the report is not available, the response will be 404 with the error message “Report not available. Please try again later.”

​
Report Contents

When completed, the report includes:
  • Risk assessment (Low/Medium/High/Very High Risk)
  • Number of criminal cases found
  • Detailed case information for each case
  • Downloadable PDF report link
  • Verified subject details

​
Credits

This operation does NOT consume credits.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
request_id
string
required

Unique request ID received from the initiate endpoint

Response

Report retrieved successfully (completed)

​
status
enum<string>
required

Overall status of the API

Available options:
success,
error
​
code
integer
required

HTTP status code

Example:

400

​
message
string
required

Description of the response or error

Example:

"Invalid request parameters"

​
credits_used
integer
required

Represents the total number of credits used in this request.

Example:

3

​
credits_left
integer
required

Represents the remaining credits available for use.

Example:

4040

​
data
object