> ## 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 Crime Report

> Retrieves the crime check verification report using the request ID

## Overview

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

## Report Status

| Status          | HTTP Code | Description                                      |
| :-------------- | :-------- | :----------------------------------------------- |
| **Completed**   | 200       | Report is ready with full details                |
| **In Progress** | 202       | Report is still being processed, try again later |
| **Failed**      | 400       | Verification failed or encountered an error      |

<Warning>
  If the report is not available, the response will be 404 with the error
  message "Report not available. Please try again later."
</Warning>

## 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.


## OpenAPI

````yaml GET /v2/verification/crime-check/
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/verification/crime-check/:
    get:
      tags:
        - Background Verification
        - Crime Check
      summary: Get Crime Check Report
      description: >-
        Retrieves a completed or in-progress crime check report using the
        request_id. This operation does NOT consume credits.
      operationId: getCrimeCheckReport
      parameters:
        - name: request_id
          in: query
          required: true
          description: Unique request ID received from the initiate endpoint
          schema:
            type: string
          example: '2771138874513'
      responses:
        '200':
          description: Report retrieved successfully (completed)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrimeCheckReportSuccessResponse'
              examples:
                no_records:
                  summary: No criminal records found
                  value:
                    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
                with_records:
                  summary: Criminal records found
                  value:
                    status: success
                    code: 200
                    message: Operation completed successfully
                    data:
                      status: completed
                      request_id: '1597298625363'
                      risk_assessment:
                        risk_type: Very High Risk
                        risk_summary: >-
                          There is a pending case filed against the subject,the
                          case is filed for Husband or relative of husband of a
                          woman subjecting her to cruelty.
                        number_of_cases: 1
                      download_link: >-
                        https://crime.getupforchange.com/api/v3/downloadReport/1597298625363/<token>
                      cases:
                        - slNo: 1
                          petitioner: Antophill Police Staion
                          respondent: Sanjay Akhilesh Gupta
                          cinNumber: MHMM130045422012
                          caseTypeName: PW - Police Warrant Trible
                          courtName: Additional Chief Metropolitan Magistrate, Kurla,M
                          state: MAHARASHTRA
                          district: MUMBAI
                          petitionerAddress: >-
                            1) Name: Antophill Police StaionAddress: C.G.S.
                            Colony, Sector No. 6, Kane Nagar Antophill, Mumbai
                          respondentAddress: >-
                            1) Name: Sanjay Akhilesh GuptaAddress: B. NO. B-1
                            ROOM NO. 18 SARDAR NGR NO. 4 SION KOLIWADA MUMBAI
                            37gfc_pincode: 400037
                          caseNumber: '208551015842012'
                          caseYear: '2012'
                          underAct: U/s 498A406, Indian Penal Code
                          section: 498A406
                          caseStatus: Pending
                          firLink: N/A
                          judgementLink: >-
                            https://judgements.getupforchange.com/MHMM130045422012.pdf
                          caseLink: https://services.ecourts.gov.in/ecourtindia_v6/
                          caseType: Criminal
                          caseRemarks: >-
                            Address: B. NO. B-1 ROOM NO. 18 SARDAR NGR NO. 4
                            SION KOLIWADA MUMBAI 37
                          natureOfDisposal: ''
                          final_riskType: null
                          final_riskSummary: null
                          courtType: Magistrate Court
                          caseDetailsLink: >-
                            https://crime.getupforchange.com/getDetails?id=AWK5YCr-aQi7HkqivKOM
                    credits_used: 0
                    credits_remaining: 984418.5
        '202':
          description: Report still processing - Try again later
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrimeCheckReportProcessingResponse'
              examples:
                processing:
                  summary: Report in progress
                  value:
                    status: success
                    code: 202
                    message: Report is still being processed
                    data:
                      status: in_progress
                      request_id: '2771138874513'
                      request_time: 16/02/2026 10:16:39
                      message: >-
                        Crime check is in progress. Please try again after some
                        time.
                      estimated_time: Report typically takes 24-48 hours
                    credits_used: 0
                    credits_remaining: 985101.5
        '400':
          description: Bad Request - Invalid request_id or report error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error_WithCredits'
              examples:
                missing_request_id:
                  summary: Missing request_id parameter
                  value:
                    status: error
                    code: 400
                    message: request_id parameter is required
                    data: null
                invalid_request_id:
                  summary: Invalid request_id format
                  value:
                    status: error
                    code: 400
                    message: Invalid request_id provided
                    data: null
        '401':
          $ref: '#/components/responses/401'
        '404':
          description: >-
            Not Found - Request ID not found or does not belong to your
            organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error_WithCredits'
              examples:
                not_found:
                  summary: Request ID not found
                  value:
                    status: error
                    code: 404
                    message: Crime check request not found
                    data: null
                report_not_available:
                  summary: Report not available
                  value:
                    status: error
                    code: 404
                    message: Report not available. Please try again later.
                    data: null
        '500':
          $ref: '#/components/responses/500_WithCredits'
components:
  schemas:
    CrimeCheckReportSuccessResponse:
      allOf:
        - $ref: '#/components/schemas/APIBaseResponse'
        - type: object
          properties:
            data:
              type: object
              properties:
                status:
                  type: string
                  enum:
                    - completed
                  example: completed
                request_id:
                  type: string
                  example: '2771138874513'
                request_time:
                  type: string
                  example: 16/02/2026 10:16:39
                risk_assessment:
                  type: object
                  properties:
                    risk_type:
                      type: string
                      enum:
                        - Low Risk
                        - Medium Risk
                        - High Risk
                        - Very High Risk
                      example: Low Risk
                    risk_summary:
                      type: string
                      description: Summary of risk assessment findings
                      example: No criminal records found for the subject.
                    number_of_cases:
                      type: integer
                      description: Total number of criminal cases found
                      example: 0
                cases:
                  type: array
                  description: Array of criminal case details (empty if no cases found)
                  items:
                    $ref: '#/components/schemas/CriminalCase'
                subject_details:
                  type: object
                  description: Verified subject information
                  properties:
                    name:
                      type: string
                      example: RAHUL KUMAR
                    father_name:
                      type: string
                      example: VIJAY KUMAR
                    dob:
                      type: string
                      example: 15-08-1995
                    address:
                      type: string
                      example: 123 MG Road, Pune, Maharashtra, 411001
                    pan_number:
                      type: string
                      example: ABCDE1234F
                download_link:
                  type: string
                  description: URL to download the full PDF report
                  example: >-
                    https://crime.getupforchange.com/api/v3/downloadReport/2771138874513/token123
        - $ref: '#/components/schemas/Credits'
    CrimeCheckReportProcessingResponse:
      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
                  example: '2771138874513'
                request_time:
                  type: string
                  example: 16/02/2026 10:16:39
                message:
                  type: string
                  example: >-
                    Crime check is in progress. Please try again after some
                    time.
                estimated_time:
                  type: string
                  example: Report typically takes 24-48 hours
            credits_used:
              type: number
              example: 0
            credits_remaining:
              type: number
              example: 985101.5
    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'
    CriminalCase:
      type: object
      description: Details of a criminal case
      properties:
        case_number:
          type: string
          description: FIR or case registration number
          example: FIR/2020/12345
        case_type:
          type: string
          description: Type of case
          example: Criminal
        filing_date:
          type: string
          description: Date when case was filed
          example: 15-03-2020
        case_status:
          type: string
          description: Current status of the case
          example: Pending
        court_name:
          type: string
          description: Name of the court handling the case
          example: District Court, Mumbai
        sections:
          type: string
          description: Legal sections under which case is filed
          example: IPC 420, 467
        description:
          type: string
          description: Brief description of the case
          example: Cheating and forgery
    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>`.

````