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

# Get verification

> Retrieves a verification by ID



## OpenAPI

````yaml openapi/identity.yaml get /identity/verifications/{id}
openapi: 3.0.3
info:
  title: TXCloud Identity API
  version: 1.0.0
  description: >
    The TXCloud Identity API enables identity verification through document
    OCR, 

    face matching, liveness detection, and fraud checks.


    ## Base URL

    ```

    https://api.txcloud.io/v1

    ```


    ## Authentication

    All requests require a Bearer token in the Authorization header:

    ```

    Authorization: Bearer txc_live_your_api_key

    ```


    ## Rate Limits

    | Plan | Requests/min |

    |------|--------------|

    | Starter | 60 |

    | Growth | 300 |

    | Scale | 1,000 |

    | Enterprise | Custom |
  termsOfService: https://txcloud.io/terms
  contact:
    name: TXCloud API Support
    email: support@txcloud.io
    url: https://docs.txcloud.io
  license:
    name: Proprietary
    url: https://txcloud.io/license
  x-logo:
    url: https://txcloud.io/logo.png
servers:
  - url: https://api.txcloud.io/v1
    description: Production
  - url: https://sandbox.api.txcloud.io/v1
    description: Sandbox (test environment)
security:
  - BearerAuth: []
tags:
  - name: Verification
    description: Core identity verification endpoints
  - name: Management
    description: Manage and retrieve verifications
  - name: Sessions
    description: Multi-step verification sessions
  - name: Documents
    description: Document management
  - name: Configuration
    description: Supported documents and countries
paths:
  /identity/verifications/{id}:
    get:
      tags:
        - Management
      summary: Get verification
      description: Retrieves a verification by ID
      operationId: getVerification
      parameters:
        - $ref: '#/components/parameters/VerificationId'
      responses:
        '200':
          description: Verification details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Verification'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    VerificationId:
      name: id
      in: path
      required: true
      schema:
        type: string
      description: Verification ID
      example: ver_a1b2c3d4e5f6
  schemas:
    Verification:
      type: object
      properties:
        id:
          type: string
          example: ver_a1b2c3d4e5f6
        object:
          type: string
          enum:
            - identity.verification
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        status:
          type: string
          enum:
            - pending
            - verified
            - rejected
            - review
            - expired
            - error
        document_type:
          type: string
        country:
          type: string
        extracted_data:
          $ref: '#/components/schemas/ExtractedData'
        checks:
          $ref: '#/components/schemas/VerificationChecks'
        risk_score:
          type: integer
          minimum: 0
          maximum: 1000
        risk_level:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        fraud_signals:
          type: array
          items:
            $ref: '#/components/schemas/FraudSignal'
        metadata:
          type: object
    ExtractedData:
      type: object
      properties:
        document_number:
          type: string
          example: AE123456
        first_name:
          type: string
          example: Mohammed
        last_name:
          type: string
          example: El Amrani
        first_name_arabic:
          type: string
        last_name_arabic:
          type: string
        date_of_birth:
          type: string
          format: date
        gender:
          type: string
          enum:
            - M
            - F
        nationality:
          type: string
        issue_date:
          type: string
          format: date
        expiry_date:
          type: string
          format: date
        address:
          type: string
        place_of_birth:
          type: string
        mrz:
          type: string
        field_confidences:
          type: object
          additionalProperties:
            type: number
    VerificationChecks:
      type: object
      properties:
        ocr:
          $ref: '#/components/schemas/CheckResult'
        face_match:
          $ref: '#/components/schemas/FaceMatchCheck'
        liveness:
          $ref: '#/components/schemas/LivenessCheck'
        fraud:
          $ref: '#/components/schemas/FraudCheck'
        duplicate:
          $ref: '#/components/schemas/CheckResult'
    FraudSignal:
      type: object
      properties:
        code:
          type: string
        severity:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        message:
          type: string
    CheckResult:
      type: object
      properties:
        status:
          type: string
          enum:
            - passed
            - failed
            - skipped
            - error
        confidence:
          type: number
          format: float
          minimum: 0
          maximum: 1
    FaceMatchCheck:
      allOf:
        - $ref: '#/components/schemas/CheckResult'
        - type: object
          properties:
            similarity_score:
              type: number
              format: float
            threshold:
              type: number
              format: float
    LivenessCheck:
      allOf:
        - $ref: '#/components/schemas/CheckResult'
        - type: object
          properties:
            is_live:
              type: boolean
            spoof_probability:
              type: number
              format: float
    FraudCheck:
      allOf:
        - $ref: '#/components/schemas/CheckResult'
        - type: object
          properties:
            tampering_detected:
              type: boolean
            signals:
              type: array
              items:
                type: string
  responses:
    NotFound:
      description: Not Found
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key as Bearer token

````