{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/thomson-reuters/json-schema/thomson-reuters-user-collection-schema.json",
  "title": "UserCollection",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/thomson-reuters-users-api-openapi.yml#/components/schemas/UserCollection",
  "type": "object",
  "properties": {
    "value": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/User"
      }
    }
  },
  "additionalProperties": false,
  "$defs": {
    "AddressType": {
      "enum": [
        "Work",
        "Home",
        "Other"
      ],
      "type": "string"
    },
    "CompanyUser": {
      "type": "object",
      "properties": {
        "companyUserStatus": {
          "$ref": "#/$defs/UserStatus"
        },
        "deactivatedDateTime": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "notes": {
          "type": [
            "string",
            "null"
          ]
        },
        "reqTimeEntryStartDateTime": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "employeeId": {
          "type": [
            "string",
            "null"
          ]
        },
        "annualEmployeeCost": {
          "type": [
            "number",
            "null"
          ],
          "format": "double"
        },
        "avgHours": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32"
        },
        "lastInvoicePostMethod": {
          "$ref": "#/$defs/InvoiceEditContext"
        },
        "securityRoleVersionDateTime": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "specialMatterAccess": {
          "$ref": "#/$defs/SpecialMatterAccess"
        }
      },
      "additionalProperties": false
    },
    "ContactAddress": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32"
        },
        "street1": {
          "type": [
            "string",
            "null"
          ]
        },
        "street2": {
          "type": [
            "string",
            "null"
          ]
        },
        "city": {
          "type": [
            "string",
            "null"
          ]
        },
        "country": {
          "$ref": "#/$defs/Country"
        },
        "state": {
          "$ref": "#/$defs/State"
        },
        "provinceRegion": {
          "type": [
            "string",
            "null"
          ]
        },
        "zip": {
          "type": [
            "string",
            "null"
          ]
        },
        "addressType": {
          "$ref": "#/$defs/AddressType"
        }
      },
      "additionalProperties": false
    },
    "ContactPhone": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32"
        },
        "phoneNumber": {
          "type": [
            "string",
            "null"
          ]
        },
        "phoneType": {
          "$ref": "#/$defs/PhoneType"
        }
      },
      "additionalProperties": false
    },
    "Country": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32"
        },
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "isoCode": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "DateFormat": {
      "enum": [
        "mmddyyyy",
        "ddmmyyyy"
      ],
      "type": "string"
    },
    "InvoiceEditContext": {
      "enum": [
        "SpeedPost",
        "ManualLedes",
        "ManualOther",
        "LedesGenerator",
        "Accounting",
        "Move"
      ],
      "type": "string"
    },
    "PhoneType": {
      "enum": [
        "Work",
        "Home",
        "Fax",
        "Mobile",
        "Other"
      ],
      "type": "string"
    },
    "Profile": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32"
        },
        "dateFormat": {
          "$ref": "#/$defs/DateFormat"
        },
        "browseItemsPerPage": {
          "type": "integer",
          "format": "int32"
        },
        "notifyMaterialChange": {
          "type": "boolean"
        },
        "notifyPendingInvoice": {
          "type": "boolean"
        },
        "notifyBudgetChange": {
          "type": "boolean"
        },
        "notifyStatusDue": {
          "type": "boolean"
        },
        "notifyDocumentReview": {
          "type": "boolean"
        },
        "notifyMatterClosed": {
          "type": "boolean"
        },
        "notifyTKRateReview": {
          "type": "boolean"
        },
        "currency": {
          "type": [
            "string",
            "null"
          ]
        },
        "budgetDueNoticeDays": {
          "type": "integer",
          "format": "int32"
        }
      },
      "additionalProperties": false
    },
    "SpecialMatterAccess": {
      "type": "object",
      "properties": {
        "organizationalUnitIds": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "integer",
            "format": "int32"
          }
        },
        "practiceGroupIds": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "additionalProperties": false
    },
    "State": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32"
        },
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "isoCode": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "User": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32"
        },
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "userId": {
          "type": [
            "string",
            "null"
          ]
        },
        "eMail": {
          "type": [
            "string",
            "null"
          ]
        },
        "createdDateTime": {
          "type": "string",
          "format": "date-time"
        },
        "userType": {
          "$ref": "#/$defs/UserType"
        },
        "loginAttempts": {
          "type": "integer",
          "format": "int32"
        },
        "loginTempLockoutExpirationDateTime": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "masterUserStatus": {
          "$ref": "#/$defs/UserStatus"
        },
        "firstName": {
          "type": [
            "string",
            "null"
          ]
        },
        "lastName": {
          "type": [
            "string",
            "null"
          ]
        },
        "deactivatedDateTime": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "companyId": {
          "type": "integer",
          "format": "int32"
        },
        "firmOfficeId": {
          "type": "integer",
          "format": "int32"
        },
        "companyOfficeId": {
          "type": "integer",
          "format": "int32"
        },
        "roles": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "$ref": "#/$defs/UserRoles"
          }
        },
        "masterCompanyId": {
          "type": "integer",
          "format": "int32"
        },
        "lastLoginDateTime": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "recipientContactPrimaryUserId": {
          "type": "integer",
          "format": "int32"
        },
        "recipientContactSecondaryUserId": {
          "type": "integer",
          "format": "int32"
        },
        "onePassIdentifier": {
          "type": [
            "string",
            "null"
          ]
        },
        "onePassRegistrationKey": {
          "type": [
            "string",
            "null"
          ]
        },
        "azureObjectId": {
          "type": [
            "string",
            "null"
          ]
        },
        "b2cObjectId": {
          "type": [
            "string",
            "null"
          ]
        },
        "uid": {
          "type": "string",
          "format": "uuid"
        },
        "primaryAddress": {
          "$ref": "#/$defs/ContactAddress"
        },
        "primaryPhone": {
          "$ref": "#/$defs/ContactPhone"
        },
        "companyUser": {
          "$ref": "#/$defs/CompanyUser"
        },
        "profile": {
          "$ref": "#/$defs/Profile"
        }
      },
      "additionalProperties": false
    },
    "UserRoles": {
      "enum": [
        "WebServicesAccess",
        "CanPostToAllMatters",
        "FirmInvoiceAttachmentAccessAllInvoices",
        "FirmInvoiceAttachmentAccessInvoicesInUsersOfficeOnly",
        "SerengetiAdmin",
        "ConcourseAlertUser",
        "SerengetiIM",
        "ThirdPartyBiller",
        "GeneralCounsel",
        "TKRateReviewer",
        "InvoiceReportAccess",
        "BudgetReportAccess",
        "OtherReportAccess",
        "InvoiceAccessProfileAndAttachmentForReports",
        "InvoiceAccessProfileOnlyForReports",
        "AnalyticsAccess",
        "MatterUploadAccess",
        "APDataExchangeAccess",
        "ReportsAPIAccess",
        "CanPreApproveAllocationsOnUpdate",
        "ScheduledReportsAccess",
        "FirmMatterDataUpload",
        "InvoiceRejector",
        "LegalHoldsReportCreation",
        "SOPAccess",
        "PowerBIDashboardsAccess",
        "PowerBIDashboardManagerEditAccess",
        "PowerBIDashboardManagerViewAccess",
        "CompanyBilling",
        "CompanyReporter",
        "CompanyReader",
        "CompanyEditor",
        "CompanyAdmin",
        "SystemReader",
        "SystemEditor",
        "SystemOfficeAdmin",
        "SystemAdmin"
      ],
      "type": "string",
      "description": "<li>'WebServicesAccess' - Web Services Account for API-based data exchange</li><li>'CanPostToAllMatters' - Can edit all matters</li><li>'FirmInvoiceAttachmentAccessAllInvoices' - Can access all invoices</li><li>'FirmInvoiceAttachmentAccessInvoicesInUsersOfficeOnly' - Can access all invoices in user's office only</li><li>'SerengetiAdmin' - Master company Serengeti administrator</li><li>'ConcourseAlertUser' - Concourse alert user</li><li>'SerengetiIM' - Master company Serengeti client relationship manager</li><li>'ThirdPartyBiller' - Third party biller user</li><li>'GeneralCounsel' - General counsel user</li><li>'TKRateReviewer' - Timekeeper rate reviewer</li><li>'InvoiceReportAccess' - Can access invoice reports</li><li>'BudgetReportAccess' - Can access budget reports</li><li>'OtherReportAccess' - Can access other reports</li><li>'InvoiceAccessProfileAndAttachmentForReports' - Can access invoice profile and attachment for reports</li><li>'InvoiceAccessProfileOnlyForReports' - Can access invoice profile only for reports</li><li>'AnalyticsAccess' - Can access company analytics</li><li>'MatterUploadAccess' - Can access matter upload</li><li>'APDataExchangeAccess' - Can access Accounts Payable (AP) data exchange</li><li>'ReportsAPIAccess' - Can access reports API</li><li>'CanPreApproveAllocationsOnUpdate' - Can use pre approved allocations with matter upload API</li><li>'ScheduledReportsAccess' - Can schedule reports</li><li>'FirmMatterDataUpload' - Can access firm matter data upload</li><li>'InvoiceRejector' - Can reject invoices</li><li>'LegalHoldsReportCreation' - Can create legal hold reports</li><li>'SOPAccess' - Can access Service of Process (SOP)</li><li>'PowerBIDashboardsAccess' - Can access Power BI dashboards</li><li>'PowerBIDashboardManagerEditAccess' - Can edit Power BI dashboard manager</li><li>'PowerBIDashboardManagerViewAccess' - Can view Power BI dashboard manager</li><li>'CompanyBilling' - Can access company as a biller</li><li>'CompanyReporter' - Can access company for reports only</li><li>'CompanyReader' - Can access company as a reader</li><li>'CompanyEditor' - Can access company as an editor</li><li>'CompanyAdmin' - Can access company as an administrator</li><li>'SystemReader' - Can access system as a reader</li><li>'SystemEditor' - Can access system as an editor</li><li>'SystemOfficeAdmin' - Can access system as an office administrator</li><li>'SystemAdmin' - Can access system as an administrator</li>"
    },
    "UserStatus": {
      "enum": [
        "Active",
        "InactiveImplicit",
        "InactiveExplicit"
      ],
      "type": "string"
    },
    "UserType": {
      "enum": [
        "Company",
        "Firm"
      ],
      "type": "string"
    }
  }
}