Search user by ID and return basic user information

Prev Next
Get
/user/{id}
Security
HTTP
Type basic

HTTP Basic authentication using your Tenant ID and API secret.

  • Username is the Tenant ID (i.e. eu-west-2_AbcdEfghI)
  • Password is the API secret you would have received.

You can also authenticate using OAuth 2.0 client credentials (oauth2 security scheme) instead of Basic auth.

OAuth

OAuth 2.0 client credentials authentication.

Use the following token endpoints (replace :tenantId with your Tenant ID):

  • Public API access tokens

    • Staging: https://public.api.learnstaging.link/oauth2/token/:tenantId
    • Production: https://public.api.learn.link/oauth2/token/:tenantId
    • Staging MEA: https://public.api.meastaging.learn.tech/oauth2/token/:tenantId
    • Production MEA: https://public.api.mea.learn.tech/oauth2/token/:tenantId
  • Webhooks access tokens

    • Staging: https://user.api.learnstaging.link/oauth2/token/:tenantId
    • Production: https://user.api.learn.link/oauth2/token/:tenantId
    • Staging MEA: https://user.api.meastaging.learn.tech/oauth2/token/:tenantId
    • Production MEA: https://user.api.mea.learn.tech/oauth2/token/:tenantId

All access tokens must be sent using the Authorization: Bearer <access_token> header.

Scopes

For API access (non-webhooks), the following scopes are available:

  • api/all – Full read and write access to the API.
  • api/read – Read-only access to the API.
  • api/write – Write access to the API.

For webhooks, the following scopes are available:

  • api/webhooks – Access to webhook functionality.
  • api/all – Full read and write access to the API, including webhooks.

Tokens must include appropriate scopes for the endpoints you wish to call.

FlowClient Credentials
Token URLhttps://public.api.learn.link/oauth2/token/:tenantId
Path parameters
id
stringRequired

Filter by user

Example64676ab0a236ebc50f280a55
Responses
200

The user

Expand All
object

A user object

id
string

The user's ID

Example646767d82535201223349e09
ref
string | null

The user's ref

Examplexyzabc
firstName
string | null

The user's first name

ExampleJohn
lastName
string | null

The user's last name

ExampleDoe
email
string | null

The user's email

Examplesample@thrivelearning.com
role
string | null

The user's role

Examplelearner
status
string | null

The user's status

Exampleactive
positions
Array of object (UserPosition)

The user's positions

object

User Position

id
string

The user ID

Example646767d82535201223349e09
manager
object | null

The user's management position

Example{ "id": "646767d82535201223349e09" }
ouId
string | null
Example646767d825
isActive
boolean

Defines whether the user is active

Exampletrue
startDate
string (date-time) | null
Example2021-01-01T09:00:00Z
endDate
string (date-time) | null
Example2021-01-01T09:00:00Z
createdAt
string (date-time) | null
Example2021-01-01T09:00:00Z
updatedAt
string (date-time) | null
Example2021-01-01T09:00:00Z
additionalFields
object | null

Additional fields

Example{ "location": "London" }
languageCode
string | null

The user's language code

Exampleen-gb
deleted
boolean

Defines whether the user has been deleted

Examplefalse
compliance
number

The user's compliance score

Example0.0
level
number

The user's level

Example0.0
firstLogin
string (date-time) | null
Example2021-01-01T09:00:00Z
lastLogin
string (date-time) | null
Example2021-01-01T09:00:00Z
tags
object
skills
string
ExampleLeadership
usersFollowing
Array of string
Example[ "646767d82535201223349e09" ]
string
tagsFollowing
Array of string
Example[ "646767d82535201223349e09" ]
string
createdAt
string (date-time) | null
Example2021-01-01T09:00:00Z
updatedAt
string (date-time) | null
Example2021-01-01T09:00:00Z
hasPicture
boolean

Defines whether the user has a profile picture

Examplefalse
timeZone
string | null

The user's time zone

ExampleEurope/London
summary
string | null

The user's summary

ExampleA summary of the user
relevancy
number

The user's relevancy score

Example0.0
rank
object
currentCategory
string
ExampleBeginner
currentRank
number
Example1.0
agreedTerms
boolean | null

Defines whether the user has agreed to the terms

Exampletrue
onboarded
boolean | null

Defines whether the user has been onboarded

Exampletrue
audiences
Array of string
Example[ "646767d82535201223349e09" ]
string
singleSignOn
boolean

Defines whether the user is using single sign-on

Exampletrue
400

Bad Request

object

Bad Request

status
number
Example400.0
error
string
ExampleBad Request
message
string #deprecatedtemplate# #additional-property-template#
OneOf
string
string
object
object
401

Unauthorized

object

Unauthorized

status
number
Example401.0
error
string
ExampleUnauthorized
message
string
404

Not Found

object

Not found

status
number
Example404.0
error
string
ExampleNot Found
message
string #deprecatedtemplate# #additional-property-template#
OneOf
string
string
object
object
default

Internal Server Error

object

Internal Server Error

status
number
Example500.0
error
string
ExampleInternal Server Error
message
string