---
title: "Get session by access token"
method: GET
path: "/api/v1/v/{token}"
tags: ["Session Access"]
---

# Get session by access token

`GET /api/v1/v/{token}`

## Request

- Base URL: `https://api.korala.ai`
- URL: `https://api.korala.ai/api/v1/v/{token}`
- Auth: none declared

## Path parameters

- `token` string, required

## Response `200`

- SessionAccessDto
  - `sandbox` boolean, required: Persisted execution mode: true for test data
  - `id` string, required
  - `status` 'created' | 'in_progress' | 'pending_review' | 'completed' | 'expired' | 'failed', required
  - `resolution` 'approved' | 'rejected'
  - `redirectUrl` string, nullable
  - `expiresAt` string, date-time, nullable
  - `participants` SessionAccessParticipantDto[], required
    - `id` string, required
    - `role` 'subject' | 'beneficial_owner' | 'controller' | 'director' | 'representative', required
    - `displayName` string, nullable
  - `workflows` SessionAccessWorkflowDto[], required: Ordered list of workflows in this session
    - `id` string, required
    - `workflowDefinitionId` string, required
    - `workflowName` string, nullable
    - `workflowSlug` string, nullable
    - `workflowRunId` string, nullable
    - `outputKey` string, required
    - `participantId` string, nullable
    - `participantRole` 'subject' | 'beneficial_owner' | 'controller' | 'director' | 'representative'
    - `participantDisplayName` string, nullable
    - `order` number, required
    - `status` 'pending' | 'in_progress' | 'completed' | 'failed' | 'resubmit_required', required
    - `context` object, nullable
    - `attemptCount` number, required
    - `maxAttempts` number, required
    - `resubmissionReasons` string[], nullable: Why Korala asked for this workflow again: capture reason codes the person can act on (capture.document_expired, capture.document_unsupported, capture.image_unreadable, capture.side_missing, capture.file_too_large, capture.document_no_face, capture.selfie_no_face, capture.selfie_multiple_faces, capture.selfie_too_dark, capture.selfie_blurry). Kept while the redo runs and cleared when the workflow next completes. Null when nobody asked, or when the partner did.
    - `documentChoice` SessionDocumentChoiceDto
      - `country` string, required: ISO 3166-1 alpha-2
      - `type` 'passport' | 'national_id' | 'driving_license', required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `currentWorkflow` SessionAccessWorkflowDto
    - `id` string, required
    - `workflowDefinitionId` string, required
    - `workflowName` string, nullable
    - `workflowSlug` string, nullable
    - `workflowRunId` string, nullable
    - `outputKey` string, required
    - `participantId` string, nullable
    - `participantRole` 'subject' | 'beneficial_owner' | 'controller' | 'director' | 'representative'
    - `participantDisplayName` string, nullable
    - `order` number, required
    - `status` 'pending' | 'in_progress' | 'completed' | 'failed' | 'resubmit_required', required
    - `context` object, nullable
    - `attemptCount` number, required
    - `maxAttempts` number, required
    - `resubmissionReasons` string[], nullable: Why Korala asked for this workflow again: capture reason codes the person can act on (capture.document_expired, capture.document_unsupported, capture.image_unreadable, capture.side_missing, capture.file_too_large, capture.document_no_face, capture.selfie_no_face, capture.selfie_multiple_faces, capture.selfie_too_dark, capture.selfie_blurry). Kept while the redo runs and cleared when the workflow next completes. Null when nobody asked, or when the partner did.
    - `documentChoice` SessionDocumentChoiceDto
      - `country` string, required: ISO 3166-1 alpha-2
      - `type` 'passport' | 'national_id' | 'driving_license', required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

---

[API](https://skmtc.dev/korala/apis/korala-public-api.md) · [All operations](https://skmtc.dev/korala/apis/korala-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/korala/apis/korala-public-api/revisions/5c4d7810c507?raw)