Loading ...

REST API: Get User | Axero Documentation

Home » axero documentation » Wiki » Documentation » REST API Overview » REST API: Users » REST API: Get User
Axero Documentation  Wiki
Public Space
Activity Stream Content
Version 50

REST API: Get User

0 
 /5
0 (0votes)
Open API Guide
GET/api/users/{UserID}/details

Look up a user by their unique ID. This is the standard way to grab basic info for any community member. Use this when you have a UserID from another data source and need to show their name or profile picture quickly.

Request

Request Header

Header Required Value Description
Authorization YES Bearer YOUR_TOKEN Bearer token for the authenticated user. Learn how to create Bearer tokens.

Required Parameters

Parameter Type Required Location Description
UserID Integer YES Path Unique identifier for a particular user

Optional Parameters

Parameter Type Required Location Description
LogView Boolean NO Query Logs the API call as an action in User Activity when set to true
ProfileLastModifiedAfter String NO Query The profile last modified after date in ISO format
ProfileLastModifiedBefore String NO Query The profile last modified before date in ISO format

Example

Request Header

Authorization: Bearer YOUR_TOKEN

Request URL

https://your-site.com/api/users/1311/details

Success Response

{
  "IsError": false,
  "ResponseMessage": "",
  "ResponseData": {
    "AvatarImageURL": "https://your-site.com/Assets/Uploaded-Photos/376/f9c8486c-f3f3-41f9-9f46-044093247dc9.jpg",
    "AvatarPath": "5e957294-635a-444d-9b07-0185d53ebc6c.jpg",
    "Bio": "

I'm excited to be able to help people achieve their potential in life, both at work and outside of the office.

",
    "BlogID": 0,
    "DOB": "1982-04-24T00:00:00",
    "DateFormat": "M/d/yyyy",
    "DateJoined": "2026-07-03T19:54:58.27",
    "DateJoinedString": "7/3/2017",
    "DateLastVisited": "2026-03-12T06:55:43.257",
    "DateLastVisitedString": "3/12/2025",
    "ProfileLastModified": "2026-03-10T18:45:22.123Z",
    "DefaultCulture": "en-US",
    "Email": "noreply@your-site.com",
    "EmailRecieve": 0,
    "SpaceDigestOption": 0,
    "FacebookURL": "https://facebook.com/axerosolutions/",
    "FavoriteBooks": "Creativity Inc., The Men Who Stare at Goats, How to Fail at Almost Everything and Still Win Big, Never Split the Difference, Who the Hell Wants to Work for You?",
    "FavoriteCuisines": "Japanese, Chinese, Thai, Hamburgers, French Fries, Ice Cream, Lollipops, Hershey bars, Cheese.",
    "FavoriteMusic": "Air, Led Zeppelin, Miles Davis, The Doors, Nine Inch Nails, techno. ",
    "FavoriteTVShows": "Dexter, Breaking Bad, X-Files, The Office.",
    "FaxNumber": "444-333-5441",
    "FirstName": "Alexis",
    "Gender": 3,
    "GoogleIM": "alexisgoogle",
    "CompanyName": "Axero Solutions",
    "ICQIM": "Axero Solutions",
    "IP": "122.160.157.8",
    "Interests": "Human Resources, helping people, business, employee engagement, intranet software.",
    "InvitationID": 0,
    "IsActivated": true,
    "IsAnonymous": false,
    "IsUserLocked": false,
    "IsBanned": false,
    "IsConfirmed": false,
    "IsContactInfoVisible": true,
    "IsFeatured": true,
    "IsIsolated": false,
    "IsProfileCompleted": true,
    "IsOptInPromotionalEmails": false,
    "IsPasswordEncrypted": true,
    "IsProfilePublic": true,
    "LastName": "Fox",
    "LinkedinURL": "https://linkedin.com/company/axero-solutions-llc",
    "Location": "San Diego, California United States",
    "MediaServerID": 62,
    "MediaServerRootURL": "https://your-site.com/Assets/Uploaded-Photos",
    "MembershipStatus": 0,
    "MetaDescription": "{{USER_NAME}} is on {{COMMUNITY_NAME}}. Join {{COMMUNITY_NAME}} to connect with {{USER_NAME}}",
    "MetaKeywords": "admin, ",
    "MetaTitle": "{{USER_NAME}} | {{COMMUNITY_NAME}}",
    "MiddleName": "Remmington",
    "NumBlogPosts": 0,
    "NumPosts": 41,
    "Occupation": "CEO",
    "PMNotification": true,
    "PhoneNumber": "+16197771858",
    "Points": 80207,
    "ProfileImageURL": "https://your-site.com/Assets/Uploaded-Photos/376/81085e30-ef6c-4928-a014-53fe56bc48a2.jpg",
    "ProfilePhoto": "profile-default.jpg",
    "ProfileURL": "https://your-site.com/people/admin",
    "OnlineChatStatus": 1,
    "RankID": 5,
    "RankImage": "rank-guru.gif",
    "RankImageURL": "https://your-site.com/Assets/Uploaded-Photos/rank-guru.gif",
    "RankName": "Expert",
    "RoleID": 0,
    "Salutation": "607",
    "ShowEmail": true,
    "Signature": "",
    "SkypeIM": "alexisskype",
    "TimeFormat": "h:mm tt",
    "TimeZoneID": "India Standard Time",
    "TimeZoneText": "(UTC+05:30) India Standard Time",
    "TwitterURL": "https://x.com/AxeroSolutions",
    "UserID": 376,
    "UserInfoDisplayName": "Alexis Fox",
    "UserName": "admin",
    "HasJoinedViaThirdPartyLogin": false,
    "IsWindowsADUser": false,
    "ChatStatusCssClass": "status-offline",
    "ChatStatusText": "Offline",
    "LastChatActivityDate": "2026-03-13T07:20:20.75",
    "UserPresenceStatus": 3,
    "SimpleFields": {
      "9": {
        "FieldUseID": 9,
        "ContentTypeID": 15,
        "DataIDs": [
          4034
        ],
        "RenderedValue": "noreply@your-site.com",
        "RenderedValues": [
          "noreply@your-site.com"
        ],
        "FieldValue2": "",
        "FieldValues2": [],
        "OptionResourceKeys": [],
        "ChildFields": {},
        "Indexed": false,
        "IsPreference": false,
        "SystemName": "SystemEmail",
        "FieldType": 1,
        "FieldSubType": 2,
        "Visibility": 0,
        "TenantID": 0
      },
      "63": {
        "FieldUseID": 63,
        "ContentTypeID": 15,
        "DataIDs": [
          4035
        ],
        "RenderedValue": "Alexis",
        "RenderedValues": [
          "Alexis"
        ],
        "FieldUTCDates": [],
        "LookupValues": [],
        "FieldValues": [
          "Alexis"
        ],
        "FieldValue2": "",
        "FieldValues2": [],
        "OptionResourceKeys": [],
        "ChildFields": {},
        "Indexed": true,
        "IsPreference": false,
        "SystemName": "FirstName",
        "FieldType": 1,
        "FieldSubType": 1,
        "Visibility": 0,
        "TenantID": 0
      },
      "InOrgChart": true,
      "Industry": "1227",
      "ConnectionStatus": 0,
      "CanChat": false,
      "SpaceIDs": [
        252,
        255
      ],
      "RoleIDsTLC": [
        1,
        2,
        3
      ],
      "ContentMemberships": [
        1781
      ],
      "CanBeConnectedInMSTeams": false,
      "DirectReports": [
        518,
        519
      ],
      "ChatWith": 1
    }
  }
}

Error Response

{
  "IsError": true,
  "ResponseMessage": "Required parameter is missing or invalid.",
  "ResponseData": null
}

Notes

ProfileLastModified

The ProfileLastModified field is a UTC timestamp included in the response body. It represents the most recent update to any tracked profile field for that user.

Use the optional query parameters ProfileLastModifiedAfter and ProfileLastModifiedBefore to filter results to users modified within a specific time range. Both parameters accept dates in ISO 8601 format using UTC.

Examples:

  • Users modified after a date: ?ProfileLastModifiedAfter=2025-03-15T14:30:00Z
  • Users modified before a date: ?ProfileLastModifiedBefore=2025-04-01T00:00:00Z
  • Users modified within a range: ?ProfileLastModifiedAfter=2025-03-01T00:00:00Z&ProfileLastModifiedBefore=2025-04-01T00:00:00Z

Configuration

The profile fields that trigger an update to the ProfileLastModified timestamp are controlled by a system property:

Property Location Description
ProfileLastModifiedTrackedFieldIds Control Panel > System > System Properties A comma-separated list of Field IDs to track. Supports system-defined fields (e.g., Email, Roles) and custom profile fields.

Tracking Behavior

  • When a user profile is saved and at least one tracked field changed, the ProfileLastModified timestamp is updated once, even if untracked fields also changed in the same operation.
  • If only untracked fields changed, the timestamp is not updated.
  • The timestamp is only updated for changes made after a field has been added to the tracked list. Previous modifications are not retroactively tracked.
  • Newly created custom profile fields are not tracked by default and must be manually added to the system property.
  • To disable tracking entirely, clear the ProfileLastModifiedTrackedFieldIds system property value.

Error Handling

Status Code Likely Cause Next Action
400 Bad Request One or more required fields are missing or invalid. (userID) Verify the request payload against the required parameters.
401 Unauthorized Missing or invalid Bearer token. Check token validity. Learn how to create Bearer tokens →
403 Forbidden User does not have sufficient permissions. Confirm the user has the required roles for this action.
404 Not Found The specified user was not found. Verify the userID is correct.
500 Server Error Internal failure. Retry later.

Rate Limits

While Axero does not enforce hard rate limits by default, we recommend the following best practices to ensure optimal performance:

  • Sustained Request Rate: Do not exceed 5 API calls per second
  • Sequential Processing: Wait for each request to complete before sending the next in automated workflows
  • Concurrent Connections: If parallel processing is required, limit to 3 or fewer simultaneous requests
  • Response Timeout: Ensure API responses complete within 15 seconds during testing

Axero may implement temporary rate restrictions if excessive API usage affects overall site performance. For high-volume integrations, contact Axero to discuss your requirements.

Wiki Index

Pages