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

# Get hosted KYC session

> Returns a session by ID when owned by the requesting user or their workspace.



## OpenAPI

````yaml api-reference/openapi.json get /v1/kyc/sessions/{sessionId}
openapi: 3.1.0
info:
  title: VerisecID KYC API
  description: Hosted KYC sessions to verify users via a secure, managed flow.
  version: 1.0.0
servers:
  - url: https://api.verisecid.com
security:
  - bearerAuth: []
tags:
  - name: Hosted sessions
    description: Create and manage hosted verification sessions
  - name: Direct verification
    description: Run verification with provided images using a secret key
  - name: Webhooks
    description: Receive verification events and test deliveries
paths:
  /v1/kyc/sessions/{sessionId}:
    get:
      tags:
        - Hosted sessions
      summary: Get hosted KYC session
      description: >-
        Returns a session by ID when owned by the requesting user or their
        workspace.
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Session details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Session'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    Session:
      type: object
      properties:
        sessionId:
          type: string
        verificationUrl:
          type: string
          format: uri
        workspaceId:
          type: string
        userId:
          type: string
        status:
          type: string
          enum:
            - not_started
            - processing
            - completed
            - failed
        kycStatus:
          type:
            - string
            - 'null'
          enum:
            - Approved
            - Submitted
            - Declined
            - null
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        redirectUrl:
          type:
            - string
            - 'null'
          format: uri
        metadata:
          type:
            - object
            - 'null'
          additionalProperties: true
        applicantFirstName:
          type:
            - string
            - 'null'
        applicantLastName:
          type:
            - string
            - 'null'
        applicant:
          type:
            - string
            - 'null'
          description: Full applicant name
        detectedDocumentType:
          type:
            - string
            - 'null'
        expectedDocumentType:
          type:
            - string
            - 'null'
        retryAttempt:
          type: integer
          description: Number of retry attempts
        document:
          type:
            - object
            - 'null'
          description: Extracted document details and scores
          additionalProperties: true
        face:
          type:
            - object
            - 'null'
          description: Face match details
          additionalProperties: true
        overall:
          type:
            - object
            - 'null'
          description: Overall verification result
          additionalProperties: true
        images:
          type:
            - object
            - 'null'
          properties:
            documentFrontPath:
              type:
                - string
                - 'null'
            documentFrontUrl:
              type:
                - string
                - 'null'
              format: uri
            documentBackPath:
              type:
                - string
                - 'null'
            documentBackUrl:
              type:
                - string
                - 'null'
              format: uri
            selfiePaths:
              type: array
              items:
                type: string
            selfieUrls:
              type: array
              items:
                type: string
                format: uri
          additionalProperties: false
        verification:
          type:
            - object
            - 'null'
          properties:
            pass:
              type:
                - boolean
                - 'null'
            document:
              type: object
              additionalProperties: true
            face:
              type: object
              additionalProperties: true
            overall:
              type: object
              additionalProperties: true
          additionalProperties: true
      required:
        - sessionId
        - verificationUrl
        - workspaceId
        - userId
        - status
        - createdAt
    Error:
      type: object
      properties:
        error:
          type:
            - string
            - integer
        message:
          type: string
      required:
        - error
  responses:
    Unauthorized:
      description: Missing or invalid authentication
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Authenticated but not allowed to access this resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````