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

# Get verification status

> Retrieves the current status of a biometric verification. The status can be in multiple states: 'pending' (initial state), 'approved' (all verifications passed), 'declined' (verifications failed), or 'review' (marked for manual review).



## OpenAPI

````yaml /specs/retail.openapi.json get /v1/verification/status
openapi: 3.0.3
info:
  title: Control Orchestrator API
  description: API for orchestrating identity verification and key management workflows
  version: 1.0.0
servers:
  - url: https://orchestrator.control.coincover.com
    description: Production server
  - url: https://orchestrator.uat-control.coincover.com
    description: Development server
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Verification
    description: Start, check, and simulate biometric identity verification.
  - name: Keys
    description: Generate, assign, and verify cryptographic keys.
  - name: Backups
    description: Store and recover encrypted backup data.
paths:
  /v1/verification/status:
    get:
      tags:
        - Verification
      summary: Get verification status
      description: >-
        Retrieves the current status of a biometric verification. The status can
        be in multiple states: 'pending' (initial state), 'approved' (all
        verifications passed), 'declined' (verifications failed), or 'review'
        (marked for manual review).
      operationId: getVerificationStatus
      parameters:
        - name: verification_id
          in: query
          required: true
          schema:
            type: string
          description: Verification ID to check status for
          example: inq_abc123xyz
      responses:
        '200':
          description: Verification status retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerificationStatus'
components:
  schemas:
    VerificationStatus:
      type: object
      properties:
        verification_id:
          type: string
          description: Unique identifier for the biometric verification
          example: inq_abc123xyz
        status:
          type: string
          enum:
            - pending
            - approved
            - declined
            - review
          description: Status of the biometric verification
          example: approved
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the status was last updated
          example: '2024-01-15T10:30:00Z'
      required:
        - verification_id
        - status
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key for authentication and authorization
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: ID token as Bearer token

````