Skip to main content
GET
/
users
/
{user_id}
Retrieve user details
curl --request GET \
  --url https://api.superthread.com/v1/users/{user_id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.superthread.com/v1/users/{user_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.superthread.com/v1/users/{user_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.superthread.com/v1/users/{user_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.superthread.com/v1/users/{user_id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.superthread.com/v1/users/{user_id}")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.superthread.com/v1/users/{user_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "user": {
    "id": "u-dsu0j19",
    "email": "user@example.com",
    "email_confirmed": true,
    "first_name": "John",
    "last_name": "Smith",
    "display_name": "pete",
    "profile_image": "https://s3..../avatar.png",
    "thumbnail_image": "https://s3..../avatar.png",
    "color": "red",
    "teams": [
      {
        "archived": {
          "user_id": "uDsu0j19",
          "time_archived": 1608742037016
        },
        "id": "t-iwquhs1",
        "sub_domain": "apple",
        "team_name": "Apple Backend",
        "company_name": "Apple Inc",
        "email_domain": "apple.com",
        "creator_user_id": "u-dsu0j19",
        "time_created": 1608742037016,
        "time_updated": 1608742037016,
        "trashed": {
          "user_deleted": {
            "user_id": "uDsu0j19",
            "type": "user",
            "source": {
              "type": "oauth",
              "client_id": "oczapier",
              "import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
              "agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
              "email_addr": "somebody@example.com",
              "email_verified": false,
              "on_behalf_of": "<string>"
            }
          },
          "time_deleted": 1608742037016
        },
        "logo": {
          "src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
          "id": "<string>",
          "blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
          "color": "black",
          "emoji": "thumbsup"
        },
        "subscription_plan_id": "free",
        "features": [
          {
            "id": "<string>",
            "enabled": true,
            "time_enabled": 1608742037016,
            "toggleable": true
          }
        ],
        "limits": [
          {
            "id": "<string>",
            "limit_value": "2"
          }
        ],
        "team_description": "Technology company",
        "flags": [
          "ai0"
        ]
      }
    ],
    "time_created": 1608742037016,
    "time_updated": 1608742037016,
    "current_project": "<string>",
    "timezone_id": "America/Los_Angeles",
    "autodetect_timezone_id": true,
    "locale": "en",
    "transcription_keywords": [
      "<string>"
    ],
    "job_description": "software engineer",
    "rank": 1
  },
  "token_outdated": true,
  "token_privileged": true
}
{
"error": {
"id": "err5f744ab",
"code": 403,
"sec": "SEC:000-00014",
"message": "You do not have access to this resource",
"date": 1608742037016
}
}
You can replace user_id with me in order to return your own account details. (https://api.superthread.com/v1/users/me)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user_id
string
required

User ID is an alphanumerical string that identifies a user.

Response

user response

user
User · object
token_outdated
boolean
token_privileged
boolean

was the token used for this request privileged? privileged tokens are required for certain operations (update email) and are obtained from a fresh login (not a refresh).