---
title: "Poll chat ID discovery"
method: GET
path: "/api/v1/hitl/chat-id-discovery/{token}"
tags: ["HITL"]
---

# Poll chat ID discovery

`GET /api/v1/hitl/chat-id-discovery/{token}`

## Request

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

Poll for the result of a chat ID discovery token. Returns pending until the user messages the bot.

## Path parameters

- `token` string, required: Discovery token from POST /chat-id-discovery

## Response `200`

Discovery status

- ChatIdDiscoveryPollResponse: Chat ID discovery poll result
  - `status` 'pending' | 'completed', required
  - `chat_id` string

## Other responses

- `404`: Token not found or expired

---

[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)