---
title: "Get HITL config"
method: GET
path: "/api/v1/hitl/{id}"
tags: ["HITL"]
---

# Get HITL config

`GET /api/v1/hitl/{id}`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/hitl/{id}`
- Auth: HTTP bearer

Get details of a specific HITL configuration.

## Path parameters

- `id` string, required: MongoDB ObjectId

## Response `200`

HITL config details

- Hitl: HITL configuration with messaging channels and timeout
  - `id` string, required: MongoDB ObjectId
  - `user_id` string, required: MongoDB ObjectId
  - `name` string, nullable
  - `profile_id` string: MongoDB ObjectId
  - `circle_id` string: MongoDB ObjectId
  - `channels` HitlChannel[], required
    - union: A messaging channel configured for HITL approvals
      - object
        - `type` 'telegram', required
        - `config` object, required: Telegram channel configuration
          - `chat_id` string, required: Telegram chat ID for receiving approval requests
      - object
        - `type` 'whatsapp', required
        - `config` object, required: WhatsApp channel configuration — at least one of phone_number or bsuid is required
          - `phone_number` string: Phone number in E.164 format
          - `bsuid` string: WhatsApp Business-Scoped User ID (e.g. US.abc123...)
  - `timeout_seconds` integer, required
  - `status` 'pending' | 'active' | 'archived', required: Status of a HITL configuration
  - `keypair` object, nullable, required: Encryption keypair metadata (null if not configured)
    - `kid` string, required: Key identifier (SHA-256 of public key DER)
    - `has_encrypted_private_key` boolean, required: Whether encrypted private key is stored
    - `has_wrapped_dek` boolean, required: Whether the keypair carries a master-key-wrapped DEK (v2 envelope)
    - `has_backup_wrapper` boolean, required: Whether the DEK carries a recovery (backup-code) wrapper
  - `environment` 'production' | 'test', required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404`: HITL config not found

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/b15f506de696?raw)