GEgetmaintainx
Users

Get user

Changed on
get/users/{id}

Request

  • Base URL
    https://api.getmaintainx.com/v1
  • Auth
    HTTP bearer

Path parameters

idinteger required

ID of the user

Headers

x-organization-idinteger

Required if using a multi organizations token

Response

Successfully retrieved user's information

Example response

{
  "user": {
    "id": 963,
    "firstName": "John",
    "lastName": "Doe",
    "role": "MEMBER",
    "customRole": "Custom Role Name",
    "email": "user@example.com",
    "phoneNumber": "415-555-0100",
    "removedFromOrganization": true,
    "authType": "SAML",
    "hourlyRate": 120,
    "externalData": {
      "popularErpSolutionId": "asd732da"
    },
    "extraFields": {
      "Department": "Engineering"
    },
    "lastVisitedAt": "2026-05-06T12:34:56.000Z",
    "createdAt": "2026-05-06T12:34:56.000Z"
  }
}

Changes

  • 2b88e9e9811fRevision changes
    • warning

      added the new VIEW_ONLY enum value to the / response property for the response status

  • 222e6fad7c1fRevision changes
    • warning

      added the new OPERATOR enum value to the / response property for the response status

    • warning

      added the new SERVICE_ACCOUNT enum value to the / response property for the response status

    • info

      added the new optional header request parameter x-organization-id

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status