Skip to main content
GET
/
v2
/
tasks
/
Get Task Status and Result
curl --request GET \
  --url https://bgv.konnectnxt.com/api/v2/tasks/ \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "code": 200,
  "message": "Task completed successfully",
  "data": {
    "is_employed": true,
    "is_employee_name_match": true,
    "is_employer_name_match": true,
    "recent_employer_data": {
      "date_of_exit": null,
      "date_of_joining": "2023-03-15",
      "employer_confidence_score": 0.95,
      "establishment_id": "MHPUN0123456789",
      "establishment_name": "TECH SOLUTIONS PVT LTD",
      "matching_uan": "100234567890",
      "member_id": "MHPUN01234567890012345"
    },
    "status": "id_found",
    "uan": [
      "100234567890"
    ],
    "uan_details": {
      "100234567890": {
        "basic_details": {
          "aadhaar_verification_status": 1,
          "date_of_birth": "1992-07-20",
          "employee_confidence_score": 1,
          "gender": "FEMALE",
          "mobile": "9876543210",
          "name": "PRIYA SHARMA"
        },
        "employment_details": {
          "date_of_exit": null,
          "date_of_joining": "2023-03-15",
          "employer_confidence_score": 0.95,
          "establishment_id": "MHPUN0123456789",
          "establishment_name": "TECH SOLUTIONS PVT LTD",
          "leave_reason": "",
          "member_id": "MHPUN01234567890012345"
        }
      }
    }
  },
  "credits_used": 0,
  "credits_remaining": 9980.5
}

​
Overview

Use this endpoint to check the status of verifications that returned status 202 (processing).

​
Task Status

StatusHTTP CodeDescription
In Progress202Still processing, try again later
Completed200Verification complete with full results
Failed400Verification failed

​
Response

When completed (200), returns the same employment data structure as the verification endpoint.

​
Credits

This operation does NOT consume credits. You can poll multiple times without additional cost.

Authorizations

​
Authorization
string
header
required

API key issued by KonnectNXT. Pass as Authorization: Bearer <your_api_key>.

Query Parameters

​
request_id
string<uuid>
required

Request ID (UUID) received from the verification endpoint

Response

Task completed successfully - Returns verification results

​
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

Returns the same data structure as the verification endpoint on success