Describe a pending CLI login (Clerk session only)

​

Resolves a userCode to what it would authorize, so the dashboard can name the machine before asking the person to decide. Clerk dashboard session only — a CLI token (pcli_...) is rejected with 403 forbidden. See POST /v1/device/approve for why.

Returns only the CLI-supplied label and the deadline; it never exposes the device code. The userCode may be sent in any case, with or without the display hyphen.

Body
required
application/json
  • userCode
    Type: string
    required
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/device/lookup
curl https://api.useportal.co/v1/device/lookup \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "userCode": "K7WQ-3MTD"
}'

{
  "deviceRequest": {
    "name": "rodrigo-macbook",
    "requestedFrom": "Lima, PE",
    "expiresAt": "2026-07-19T12:10:00.000Z"
  }
}

The pending request.