> ## Documentation Index
> Fetch the complete documentation index at: https://docs.konnectnxt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Task Status

> Retrieves the status and result of an asynchronous task

## Overview

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

## Task Status

| Status          | HTTP Code | Description                             |
| --------------- | --------- | --------------------------------------- |
| **In Progress** | 202       | Still processing, try again later       |
| **Completed**   | 200       | Verification complete with full results |
| **Failed**      | 400       | Verification 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.


## OpenAPI

````yaml GET /v2/tasks/
openapi: 3.0.0
info:
  title: KonnectNXT API Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://bgv.konnectnxt.com/api
    description: Production
  - url: https://testbgv.konnectnxt.com/api
    description: QA
security:
  - bearerAuth: []
paths:
  /v2/tasks/:
    get:
      tags:
        - Employment Verification
        - Task Polling
      summary: Get Task Status and Result
      description: >-
        Retrieves the status and result of an asynchronous verification task.
        Use when POST endpoints return 202 status. Does NOT consume credits.
      operationId: getTaskStatus
      parameters:
        - name: request_id
          in: query
          required: true
          description: Request ID (UUID) received from the verification endpoint
          schema:
            type: string
            format: uuid
          example: 520c6357-c58c-431b-a376-acdb6975f895
      responses:
        '200':
          description: Task completed successfully - Returns verification results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskCompletedResponse'
              examples:
                epfo_success:
                  summary: EPFO verification task completed successfully
                  value:
                    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
        '202':
          description: Task still in progress - Try again later
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskInProgressResponse'
              examples:
                in_progress:
                  summary: Verification still processing
                  value:
                    status: success
                    code: 202
                    message: Verification is still processing
                    data:
                      status: in_progress
                      request_id: 520c6357-c58c-431b-a376-acdb6975f895
                      message: >-
                        Verification is still processing. Please check back
                        later.
                    credits_used: 0
                    credits_remaining: 9980.5
        '400':
          description: Bad Request - Invalid request_id or task failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error_WithCredits'
              examples:
                invalid_uuid:
                  summary: Invalid UUID format
                  value:
                    status: error
                    code: 400
                    message: Invalid request ID format. Must be a valid UUID.
                    data: null
        '401':
          $ref: '#/components/responses/401'
        '404':
          description: Task not found for the given request_id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error_WithCredits'
              examples:
                not_found:
                  summary: Task not found
                  value:
                    status: error
                    code: 404
                    message: No task found for the given request_id
                    data: null
        '500':
          $ref: '#/components/responses/500_WithCredits'
components:
  schemas:
    TaskCompletedResponse:
      allOf:
        - $ref: '#/components/schemas/APIBaseResponse'
        - type: object
          properties:
            data:
              type: object
              description: >-
                Returns the same data structure as the verification endpoint on
                success
        - $ref: '#/components/schemas/Credits'
    TaskInProgressResponse:
      allOf:
        - $ref: '#/components/schemas/APIBaseResponse'
        - type: object
          properties:
            data:
              type: object
              properties:
                status:
                  type: string
                  enum:
                    - in_progress
                  example: in_progress
                request_id:
                  type: string
                  format: uuid
                  example: 520c6357-c58c-431b-a376-acdb6975f895
                message:
                  type: string
                  example: Verification is still processing. Please check back later.
        - $ref: '#/components/schemas/Credits'
    Error_WithCredits:
      allOf:
        - $ref: '#/components/schemas/Error'
        - $ref: '#/components/schemas/APIErrorData'
        - $ref: '#/components/schemas/Credits'
    APIBaseResponse:
      type: object
      required:
        - status
        - code
        - message
      properties:
        status:
          $ref: '#/components/schemas/APIStatus'
        code:
          $ref: '#/components/schemas/HTTPCode'
        message:
          $ref: '#/components/schemas/APIMessage'
    Credits:
      type: object
      properties:
        credits_used:
          $ref: '#/components/schemas/CreditsUsed'
        credits_left:
          $ref: '#/components/schemas/CreditsLeft'
      required:
        - credits_used
        - credits_left
    Error:
      allOf:
        - $ref: '#/components/schemas/APIBaseResponse'
    APIErrorData:
      type: object
      properties:
        data:
          type: object
          nullable: true
          example: null
    APIStatus:
      type: string
      enum:
        - success
        - error
      description: Overall status of the API
    HTTPCode:
      type: integer
      description: HTTP status code
      example: 400
    APIMessage:
      type: string
      description: Description of the response or error
      example: Invalid request parameters
    CreditsUsed:
      type: integer
      description: Represents the total number of credits used in this request.
      example: 3
    CreditsLeft:
      type: integer
      description: 'Represents the remaining credits available for use. '
      example: 4040
  responses:
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - $ref: '#/components/schemas/APIErrorData'
          examples:
            Missing Token:
              summary: Bearer token is missing or invalid.
              value:
                status: error
                code: 401
                message: Bearer token is missing or invalid.
                data: null
            Incorrect Token Format:
              summary: Token format is incorrect
              value:
                status: error
                code: 401
                message: Token format is incorrect
                data: null
            No Admin Found:
              summary: No admin found for this request
              value:
                status: error
                code: 401
                message: No admin user found for this organization
                data: null
            Invalid API Key:
              summary: Invalid API Key
              value:
                status: error
                code: 401
                message: Invalid API key (organization ID)
                data: null
            User not Found:
              summary: User not found
              value:
                status: error
                code: 401
                message: User not found.
                data: null
    500_WithCredits:
      description: Internal Server Error
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - $ref: '#/components/schemas/APIErrorData'
              - $ref: '#/components/schemas/Credits'
          examples:
            Internal Server Error:
              summary: Internal Server Error.
              value:
                status: error
                code: 500
                message: Internal Server Error.
                data: null
                credits_used: 3
                credits_remaining: 178
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key issued by KonnectNXT. Pass as `Authorization: Bearer
        <your_api_key>`.

````