Users

Returns the full profile for a single user, including purchased courses and bundles, license assignments, learning path allocations, meeting attendance, and client configuration

Returns the full profile for a single user, including purchased courses and bundles, license assignments, learning path allocations, meeting attendance, and client configuration.

GEThttps://example.thoughtindustries.com/incoming/v2/users/:id

Example request

curl "https://example.thoughtindustries.com/incoming/v2/users/:id" \
  -H 'Authorization: Bearer YOUR_API_KEY'

Parameters

Name	Type	Required	Location	Description
`id`	`uuid`	Yes	path	Unique identifier of the user to retrieve.

Example response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "learnerUserId": "00000000-0000-0000-0000-000000000000",
  "managerUserId": "00000000-0000-0000-0000-000000000000",
  "clientId": "00000000-0000-0000-0000-000000000000",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "disabled": true,
  "sfAccountId": "00000000-0000-0000-0000-000000000000",
  "sfContactId": "00000000-0000-0000-0000-000000000000",
  "roleKey": "string",
  "address1": "string",
  "address2": "string",
  "city": "string",
  "state": "string",
  "zipCode": "string",
  "telephone": "string",
  "country": "string",
  "stripeCustomerId": "00000000-0000-0000-0000-000000000000",
  "externalCustomerId": "string",
  "shippingName": "string",
  "asset": "string",
  "email": "string",
  "firstName": "string",
  "lastName": "string",
  "lastActiveAt": "2024-01-01T00:00:00.000Z",
  "ref1": "string",
  "ref2": "string",
  "ref3": "string",
  "ref4": "string",
  "ref5": "string",
  "ref6": "string",
  "ref7": "string",
  "ref8": "string",
  "ref9": "string",
  "ref10": "string",
  "language": "string",
  "customFields": {},
  "purchasedBundles": [
    {
      "bundleId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "allocatedLicenses": [
    {
      "licenseId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "allocatedLearningPaths": [
    {
      "learningPathId": "00000000-0000-0000-0000-000000000000",
      "status": "string"
    }
  ],
  "purchasedCourses": [
    {
      "courseId": "00000000-0000-0000-0000-000000000000",
      "status": "string"
    }
  ],
  "waitlistedCourses": [
    {
      "courseId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "balance": 0,
  "preferredCurrency": "string"
}

Response fields

Field	Type	Description
`id`	`uuid`	Unique identifier of the user.
`learnerUserId`	`uuid`	Identifier of the associated learner user record, when the user has a dual role.
`managerUserId`	`uuid`	Identifier of the associated manager user record, when the user has a dual role.
`clientId`	`uuid`	Identifier of the client (tenant) the user belongs to.
`createdAt`	`ISO 8601 timestamp`	Timestamp when the user was created.
`disabled`	`boolean`	Whether the user account is disabled.
`sfAccountId`	`uuid`	Salesforce Account ID associated with the user.
`sfContactId`	`uuid`	Salesforce Contact ID associated with the user.
`roleKey`	`string`	Platform role key assigned to the user.
`address1`	`string`	Primary street address line.
`address2`	`string`	Secondary street address line.
`city`	`string`	City component of the address.
`state`	`string`	State or province component of the address.
`zipCode`	`string`	Postal code component of the address.
`telephone`	`string`	User's phone number.
`country`	`string`	Country component of the address.
`stripeCustomerId`	`uuid`	Stripe customer identifier for the user.
`externalCustomerId`	`string`	Identifier for the user in an external system.
`shippingName`	`string`	Name used for shipping physical goods.
`asset`	`string`	URL of the user's avatar asset.
`email`	`string`	User's email address.
`firstName`	`string`	User's first name.
`lastName`	`string`	User's last name.
`lastActiveAt`	`ISO 8601 timestamp`	Timestamp of the last recorded user activity.
`ref1`	`string`	Custom reference field 1 for storing arbitrary external data.
`ref2`	`string`	Custom reference field 2 for storing arbitrary external data.
`ref3`	`string`	Custom reference field 3 for storing arbitrary external data.
`ref4`	`string`	Custom reference field 4 for storing arbitrary external data.
`ref5`	`string`	Custom reference field 5 for storing arbitrary external data.
`ref6`	`string`	Custom reference field 6 for storing arbitrary external data.
`ref7`	`string`	Custom reference field 7 for storing arbitrary external data.
`ref8`	`string`	Custom reference field 8 for storing arbitrary external data.
`ref9`	`string`	Custom reference field 9 for storing arbitrary external data.
`ref10`	`string`	Custom reference field 10 for storing arbitrary external data.
`language`	`string`	User's preferred language (BCP 47 tag). Null for non-learner roles.
`customFields`	`object`	Key-value pairs for custom profile fields defined on the client.
`purchasedBundles`	`object[]`	Bundles the user has purchased.
`purchasedBundles.bundleId`	`uuid`	Identifier of the purchased bundle.
`allocatedLicenses`	`object[]`	Licenses allocated to the user.
`allocatedLicenses.licenseId`	`uuid`	Identifier of the allocated license.
`allocatedLearningPaths`	`object[]`	Learning paths allocated to the user.
`allocatedLearningPaths.learningPathId`	`uuid`	Identifier of the allocated learning path.
`allocatedLearningPaths.status`	`string`	Status of the learning path allocation.
`purchasedCourses`	`object[]`	Courses the user has purchased.
`purchasedCourses.courseId`	`uuid`	Identifier of the purchased course.
`purchasedCourses.status`	`string`	Enrollment status for the course.
`waitlistedCourses`	`object[]`	Courses the user is waitlisted for.
`waitlistedCourses.courseId`	`uuid`	Identifier of the waitlisted course.
`balance`	`number`	User's current credit balance.
`preferredCurrency`	`string`	User's preferred display currency (ISO 4217).