Skip to main content
GET /api/v1/forward/qr_sessions/{session_key} Returns the current status of a QR authorization session.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

​
Path parameters

ParameterTypeRequiredDescription
session_keystringYesOpaque QR session key returned by Create Channel QR Session.

​
Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/qr_sessions/qr-a1b2c3d4' \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "session_key": "qr-a1b2c3d4",
  "channel_id": "channel_dingtalk-001",
  "channel_type": "dingtalk",
  "status": "confirmed",
  "expires_at": "2026-06-18T10:05:00Z",
  "err_code": null,
  "err_msg": null
}

​
Status values

StatusDescription
waitingWaiting for scan, authorization, installation, or configuration.
scannedQR code was scanned and is waiting for mobile confirmation.
confirmedActivation succeeded. Channel binding_status becomes bound.
expiredQR session expired. Create a new QR session.
deniedUser denied authorization or cancelled installation.
errorThe third-party channel returned an unrecoverable error.

​
Errors

HTTPTypeCodeTrigger
401authentication_errorauthentication_requiredPAT invalid or expired.
404not_found_errorchannel_qr_session_not_foundQR session does not exist, is expired, or is not visible to the caller.

​
Notes

  • session_key is a short-lived opaque polling credential.
  • Poll at the returned poll_interval_seconds from the create response.
  • After confirmed, refresh Channel details.

Create channel QR session

Get a channel