Skip to content
StraventaDocs

Peek a hosted-capture session (does not consume the link)

Called by the hosted-capture page to render the flow. The single-use link token in the path IS the credential — no merchant API key. This peek does NOT consume the token; the single-use burn happens at capture submission, so refreshing the page mid-flow is safe.

GET
/v1/capture/{token}

Called by the hosted-capture page to render the flow. The single-use link token in the path IS the credential — no merchant API key. This peek does NOT consume the token; the single-use burn happens at capture submission, so refreshing the page mid-flow is safe.

Path Parameters

token*string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/capture/string"
{
  "id": "01930000-0000-7000-8000-000000000001",
  "status": "pending",
  "document_type": "ktp",
  "challenge_sequence": [
    "blink",
    "turn_left",
    "smile"
  ],
  "expires_at": "2026-06-03T12:00:00Z"
}
{
  "error": "invalid_api_key",
  "message": "API key is invalid or has been revoked",
  "request_id": "01HZ00000000000000000000AB"
}
{
  "error": "invalid_api_key",
  "message": "API key is invalid or has been revoked",
  "request_id": "01HZ00000000000000000000AB"
}

Was this page helpful?