OAuth

Look up a token operation

If the /oauth/token response was lost, send the same body here to find out what happened.

POST/oauth/operations/lookup

Request body

grant_typeobjectrequired: authorization_code refresh_token
codestring
redirect_uristring (uri)
code_verifierstring
refresh_tokenstring

Errors

HTTP	Code	Meaning
404	`OPERATION_NOT_FOUND`	No operation matches this body.

Shared codes are listed in Errors.

Request

cURL

curl -X POST "https://larm.sa/oauth/operations/lookup" \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "grant_type": "refresh_token", "refresh_token": "lar_rt_…" }'

Node.js

const response = await fetch(`https://larm.sa/oauth/operations/lookup`, {
  method: 'POST',
  headers: {
    Authorization: 'Basic ' + Buffer.from(`${process.env.CLIENT_ID}:${process.env.CLIENT_SECRET}`).toString('base64'),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "grant_type": "refresh_token",
    "refresh_token": "lar_rt_…"
  }),
})
if (!response.ok) throw new Error((await response.json()).error.code)
const { data, meta } = await response.json()

Python

import requests

response = requests.post(
    f"https://larm.sa/oauth/operations/lookup",
    auth=(CLIENT_ID, CLIENT_SECRET),
    json={
      "grant_type": "refresh_token",
      "refresh_token": "lar_rt_…"
    },
    timeout=15,
)
response.raise_for_status()
data = response.json()["data"]

PHP

$ch = curl_init("https://larm.sa/oauth/operations/lookup");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_USERPWD => "$clientId:$clientSecret",
  CURLOPT_POSTFIELDS => json_encode([
    "grant_type" => "refresh_token",
    "refresh_token" => "lar_rt_…"
  ]),
]);
$data = json_decode(curl_exec($ch), true)['data'];

Response 200

JSON

{
  "operation_id": "0e9d8c7b-6a5f-4e3d-2c1b-0a9f8e7d6c5b",
  "state": "completed",
  "result_available": false,
  "recovery": "revoke_issued_pair_then_reauthorize",
  "error_code": "RESULT_UNAVAILABLE_REAUTHORIZE"
}