Get BGV SubOrder By SubOrder ID
This endpoint retrieves a specific BGV sub-order by its sub-order ID.
Endpoint
GET /api.ezyhire.com/getBGVSubOrderBySubOrderId/{subOrderId}Headers
| Header | Type | Required | Description |
|---|---|---|---|
USER-Key | string | Yes | Your API authentication key |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
subOrderId | string | Yes | Unique identifier of the BGV sub-order |
Responses
Success Response
Status Code: 200 OK
{
"statusCode": 200,
"error": null,
"message": "BGV Sub Order fetched successfully.",
"data": {
"subOrderId": "f1662894-cda6-424f-bc8f-4ccecea1201e",
"bgvOrderId": "61571280-6597-44c2-84a6-cb813d1c30d2",
"subOrderProduct": "SSN_TRACE",
"subOrderStatus": "PENDING",
"subOrderSubStatus": "IN_PROGRESS",
"subOrderLastUpdatedOn": [2024, 1, 15, 10, 30, 0, 0],
"subOrderNotes": null,
"orderDetails": {
"order": {
"orderDate": "2024-01-15T10:30:00",
"dueDate": "2024-01-22T10:30:00",
"status": "PENDING",
"substatus": "NEED_INFO",
"subject": {
"firstName": "John",
"lastName": "Doe",
"birthdate": "1990-01-15T00:00:00",
"ssn": "123-45-6789",
"aliases": [],
"addresses": [],
"pastNames": [
{
"firstName": "John",
"middleName": "",
"lastName": "Doe",
"suffix": ""
}
]
},
"pricing": {
"cost": 0,
"courtFeeCost": 0,
"dataFeeCost": 0
},
"product": {
"category": "SSN_TRACE"
},
"jurisdiction": {
"county": "Social Security Trace",
"state": "USA",
"country": "United States"
},
"activity": [
{
"note": "Assigned to Researcher",
"addedDate": "2024-01-15T10:30:00"
},
{
"note": "Search Added",
"addedDate": "2024-01-15T10:35:00"
},
{
"note": "SSN is invalid",
"addedDate": "2024-01-15T11:00:00"
}
],
"documents": [],
"knownCases": [],
"requestCustomFields": [],
"resultCustomFields": [],
"subscribers": [],
"cases": [],
"courtCopies": [],
"isInNeed": true,
"ssnTrace": [],
"infoNeeded": [
{
"abbreviation": "Other",
"name": "Other",
"note": "SSN is invalid",
"category": "Other",
"documents": []
}
],
"mvr": {
"orderID": 0,
"records": []
}
}
},
"createdOn": [2024, 1, 15, 10, 30, 0, 0]
}
}Error Responses
Unauthorized
Status Code: 401 Unauthorized
{
"status": 401,
"message": "Invalid User/API key",
"data": "Please provide a valid User/API key"
}Internal Server Error
Status Code: 500 Internal Server Error
{
"statusCode": 500,
"error": "string",
"message": "string",
"data": "string"
}Enum Values
| Field Name | Possible Values |
|---|---|
subOrderProduct | NATCRIM, SSN_TRACE, SEX_OFFENDER, GLOBAL_SECURITY_CHECK, ID_VERIFICATION, EDUCATION_VERIFICATION, EMPLOYMENT_VERIFICATION, ADDRESS_VERIFICATION, CRIMINAL |
subOrderStatus | PENDING, COMPLETE, CANCELLED, UNKNOWN, ID_VALIDATION_FINISHED, POST_PROCESSING_FINISHED, FACE_VALIDATION_FINISHED, GOVERNMENT_VALIDATION_FINISHED, ONBOARDING_FINISHED, MANUAL_REVIEW_APPROVED, MANUAL_REVIEW_REJECTED |
subOrderSubStatus | IN_PROGRESS, NEED_INFO, QA_REVIEW, COMPLETE, CLEAR, RECORD, NO_RESULTS_FOUND, RESULTS_FOUND, VERIFIED_SUCCESS, VERIFIED_REQUIRES_REVIEW, UNVERIFIED_MISSING_INFO, UNVERIFIED_NO_RESPONSE, UNVERIFIED_DISCONNECTED, UNVERIFIED_SOURCE_INVALID, UNVERIFIED_SOURCE_REFUSED, UNVERIFIED_NO_RECORD, UNVERIFIED_CLOSED, UNVERIFIED_RETURNED, UNVERIFIED_CURRENT_EMPLOYMENT, UNVERIFIED_SELF_EMPLOYMENT, CANCELLED, CANCELLED_BILLABLE |
Example Usage
const subOrderId = "f1662894-cda6-424f-bc8f-4ccecea1201e";
const response = await fetch(`https://api.ezyhire.com/getBGVSubOrderBySubOrderId/${subOrderId}`, {
method: 'GET',
headers: {
'USER-Key': 'your-api-key-here'
}
});
const data = await response.json();