Skip to main content
GET
/
v3
/
workflows
cURL
curl -X GET 'https://verification.didit.me/v3/workflows/' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'
[
  {
    "uuid": "a1b2c3d4-5678-90ab-cdef-111111111111",
    "workflow_id": "a1b2c3d4-5678-90ab-cdef-111111111111",
    "workflow_label": "Standard KYC",
    "workflow_type": "kyc",
    "is_default": true,
    "is_archived": false,
    "total_price": "0.15",
    "min_price": "0.15",
    "max_price": "0.15",
    "features": [
      "OCR",
      "LIVENESS",
      "FACE_MATCH"
    ],
    "is_simple_workflow": true,
    "is_editable": false,
    "workflow_url": "https://verify.didit.me/session/abc123",
    "max_retry_attempts": 3,
    "retry_window_days": 7,
    "session_expiration_time": 1440,
    "version": 2,
    "status": "published",
    "has_draft": false,
    "created_by": {
      "name": "Alex Mateo",
      "email": "alex@example.com",
      "type": "user"
    },
    "updated_at": "2026-04-12T10:30:00Z"
  },
  {
    "uuid": "b2c3d4e5-6789-01bc-defa-222222222222",
    "workflow_id": "b2c3d4e5-6789-01bc-defa-222222222222",
    "workflow_label": "Full Verification + AML",
    "workflow_type": "kyc",
    "is_default": false,
    "is_archived": false,
    "total_price": "0.25",
    "min_price": "0.25",
    "max_price": "0.25",
    "features": [
      "OCR",
      "LIVENESS",
      "FACE_MATCH",
      "AML"
    ],
    "is_simple_workflow": true,
    "is_editable": true,
    "workflow_url": "https://verify.didit.me/session/def456",
    "max_retry_attempts": 3,
    "retry_window_days": 7,
    "session_expiration_time": 1440,
    "version": 1,
    "status": "draft",
    "has_draft": true,
    "created_by": {
      "name": "ops-bot",
      "email": null,
      "type": "api_key"
    },
    "updated_at": "2026-04-15T18:05:21Z"
  }
]

Authorizations

​
x-api-key
string
header
required

Response

Array of workflows ordered by created_at descending. Each item is a WorkflowListItem.

​
uuid
string<uuid>

Workflow UUID. Use as workflow_id when creating sessions.

​
workflow_label
string

Display name for the workflow

​
workflow_type
string | null

Base type: kyc, adaptive_age_verification, biometric_authentication, etc.

​
is_default
boolean

Whether this is the default workflow for new sessions

​
is_archived
boolean
​
total_price
string

Total price per verification in USD

​
min_price
string
​
max_price
string
​
features
string[]

Enabled features (e.g., OCR, LIVENESS, FACE_MATCH, AML)

​
is_simple_workflow
boolean

True if not graph-based

​
is_editable
boolean

True if no sessions have used this workflow

​
workflow_url
string
​
max_retry_attempts
integer
​
retry_window_days
integer
​
face_liveness_max_attempts
integer

Maximum liveness submissions per session. Default 3: one initial attempt plus two retries.

Required range: 1 <= x <= 3
​
face_match_max_attempts
integer

Maximum face-match submissions per session. Default 3: one initial attempt plus two retries.

Required range: 1 <= x <= 3
​
special_add_on_prices
object