GET/projects/api/v3/people.json

Returns a list of people

Retrieve all people for the provided filters.

Query Params

  • Name
    userType
    Type
    string
    Description

    user type

  • Name
    updatedAfter
    Type
    string
    Description

    date time

  • Name
    searchTerm
    Type
    string
    Description

    filter by comment content

  • Name
    orderMode
    Type
    string
    Description

    order mode

    Default
    asc
  • Name
    orderBy
    Type
    string
    Description

    order by

    Default
    name
  • Name
    lastLoginAfter
    Type
    string
    Description
  • Name
    pageSize
    Type
    integer
    Description

    Number of items in a page. (not used when generating reports) See How does paging work for more detailed documentation on pagination. Minimum: 1 Maximum: 500

    Default
    50
  • Name
    page
    Type
    integer
    Description

    Page number, this is usually used in conjunction with the parameter pageSize. (not used when generating reports) See How does paging work for more detailed documentation on pagination.

    Default
    1
  • Name
    skipCounts
    Type
    boolean
    Description

    SkipCounts allows you to skip doing counts on a list API endpoint for performance reasons.

  • Name
    showDeleted
    Type
    boolean
    Description

    include deleted items

    Default
    false
  • Name
    orderPrioritiseCurrentUser
    Type
    boolean
    Description

    Force to have the current/session user in the response

  • Name
    onlySiteOwner
    Type
    boolean
    Description
    Default
    false
  • Name
    onlyOwnerCompany
    Type
    boolean
    Description

    return people only from the owner company. This will replace any provided company ID.

    Default
    false
  • Name
    includeServiceAccounts
    Type
    boolean
    Description

    include service accounts

    Default
    false
  • Name
    includeCollaborators
    Type
    boolean
    Description

    exclude collaborators types, returning only account and contact.

    Default
    true
  • Name
    includeClients
    Type
    boolean
    Description

    include clients

    Default
    true
  • Name
    filterByNoCostRate
    Type
    boolean
    Description

    Returns users who are missing cost rates(OCA only)

  • Name
    excludeContacts
    Type
    boolean
    Description

    exclude contact types, returning only account and collaborator.

    Default
    false
  • Name
    teamIds
    Type
    array[integer]
    Description

    team ids

    Format
    Comma separated values
  • Name
    projectIds
    Type
    array[integer]
    Description

    filter by project ids

    Format
    Comma separated values
  • Name
    include
    Type
    array[string]
    Description

    include (not used when generating reports)

    Format
    Comma separated values
    Allowed values
    • companies
    • workingHours
  • Name
    ids
    Type
    array[integer]
    Description

    filter by user ids

    Format
    Comma separated values
  • Name
    fields[teams]
    Type
    array[string]
    Description
    Format
    Comma separated values
    Allowed values
    • id
    • name
    • teamLogo
    • teamLogoIcon
    • teamLogoColor
  • Name
    fields[person]
    Type
    array[string]
    Description
    Format
    Comma separated values
    Allowed values
    • id
    • firstName
    • lastName
    • title
    • email
    • companyId
    • company
    • isAdmin
    • isClientUser
    • isServiceAccount
    • type
    • deleted
    • avatarUrl
    • lengthOfDay
    • workingHoursId
    • workingHour
    • userRate
    • userCost
    • canAddProjects
  • Name
    fields[people]
    Type
    array[string]
    Description
    Format
    Comma separated values
    Allowed values
    • id
    • firstName
    • lastName
    • title
    • email
    • companyId
    • company
    • isAdmin
    • isClientUser
    • isServiceAccount
    • type
    • deleted
    • avatarUrl
    • lengthOfDay
    • workingHoursId
    • workingHour
    • userRate
    • userCost
    • canAddProjects
  • Name
    fields[companies]
    Type
    array[string]
    Description
    Format
    Comma separated values
    Allowed values
    • id
    • name
    • logoUploadedToServer
    • logoImage
  • Name
    fields[ProjectPermissions]
    Type
    array[string]
    Description
    Format
    Comma separated values
    Allowed values
    • viewMessagesAndFiles
    • viewTasksAndMilestones
    • viewTime
    • viewNotebooks
    • viewRiskRegister
    • viewEstimatedTime
    • viewInvoices
    • addTasks
    • addRisks
    • manageCustomFields
    • addExpenses
    • editAllTasks
    • addMilestones
    • addTaskLists
    • addMessages
    • addFiles
    • addTime
    • addNotebooks
    • viewLinks
    • addLinks
    • canViewForms
    • addForms
    • viewAllTimeLogs
    • setPrivacy
    • projectAdministrator
    • viewProjectUpdate
    • addProjectUpdate
    • canViewProjectMembers
    • canViewProjectBudget
    • canManageProjectBudget
    • canViewRates
    • canManageRates
    • canViewSchedule
    • canManageSchedule
    • receiveEmailNotifications
    • isObserving
    • isArchived
    • active
    • canAccess
    • inOwnerCompany
    • canManagePeople
    • canViewProjectTemplates
    • canManageProjectTemplates
  • Name
    excludeProjectIds
    Type
    array[integer]
    Description

    exclude people assigned to certain project id

    Format
    Comma separated values
  • Name
    companyIds
    Type
    array[integer]
    Description

    company ids

    Format
    Comma separated values

Responses

  • Code
    200
    Type
    object
    Schema
    Description
    200 OK
    MultiResponse contains information about a group of users.
  • Code
    400
    Type
    object
    Schema
    Description
    400 Bad Request
    ErrorResponse defines how []Error should be marshaled to JSON.
  • Code
    403
    Type
    object
    Schema
    Description
    403 Forbidden
    ErrorResponse defines how []Error should be marshaled to JSON.

Examples

200 OK

MultiResponse
{
  "included": {
    "ProjectPermissions": {
      "additionalProp": {
        "active": true,
        "addExpenses": true,
        "addFiles": true,
        "addForms": true,
        "addLinks": true,
        "addMessages": true,
        "addMilestones": true,
        "addNotebooks": true,
        "addProjectUpdate": true,
        "addRisks": true,
        "addTaskLists": true,
        "addTasks": true,
        "addTime": true,
        "canAccess": true,
        "canEditWorkflows": true,
        "canManagePeople": true,
        "canManageProjectBudget": true,
        "canManageProjectMembership": true,
        "canManageProjectTemplates": true,
        "canManageRates": true,
        "canManageSchedule": true,
        "canViewForms": true,
        "canViewProjectBudget": true,
        "canViewProjectMembers": true,
        "canViewProjectTemplates": true,
        "canViewRates": true,
        "canViewSchedule": true,
        "canViewWorkflows": true,
        "editAllTasks": true,
        "inOwnerCompany": true,
        "isArchived": true,
        "isObserving": true,
        "manageCustomFields": true,
        "projectAdministrator": true,
        "receiveEmailNotifications": true,
        "setPrivacy": true,
        "viewAllTimeLogs": true,
        "viewEstimatedTime": true,
        "viewInvoices": true,
        "viewLinks": true,
        "viewMessagesAndFiles": true,
        "viewNotebooks": true,
        "viewProjectUpdate": true,
        "viewRiskRegister": true,
        "viewTasksAndMilestones": true,
        "viewTime": true
      }
    },
    "companies": {
      "additionalProp": {
        "accounts": 0,
        "addressOne": "string",
        "addressTwo": "string",
        "budgetDistribution": [
          {
            "companyId": 0,
            "count": 0,
            "from": 0,
            "to": 0
          }
        ],
        "canSeePrivate": true,
        "cid": "string",
        "city": "string",
        "clientManagedBy": {
          "id": 0,
          "meta": {},
          "type": "string"
        },
        "clients": 0,
        "collaborators": 0,
        "companyNameUrl": "string",
        "companyUpdate": {
          "id": 0,
          "meta": {},
          "type": "string"
        },
        "contacts": 0,
        "countryCode": "string",
        "createdAt": "string",
        "emailOne": "string",
        "emailThree": "string",
        "emailTwo": "string",
        "fax": "string",
        "id": 0,
        "industry": {
          "id": 0,
          "meta": {},
          "type": "string"
        },
        "industryId": 0,
        "isOwner": true,
        "logoUrl": "string",
        "name": "string",
        "phone": "string",
        "privateNotes": "string",
        "privateNotesText": "string",
        "profileText": "string",
        "profitability": {
          "billable": 0,
          "billableTime": 0,
          "cost": 0,
          "expenses": 0,
          "loggedTime": 0,
          "nonBillableTime": 0,
          "profit": 0
        },
        "state": "string",
        "stats": {
          "projectCount": 0,
          "taskCompleteCount": 0,
          "taskCount": 0,
          "unreadEmailCount": 0
        },
        "status": "string",
        "tags": [
          {
            "id": 0,
            "meta": {},
            "type": "string"
          }
        ],
        "updatedAt": "string",
        "website": "string",
        "zip": "string"
      }
    },
    "teams": {
      "additionalProp": {
        "id": 0,
        "name": "string",
        "teamLogo": "string",
        "teamLogoColor": "string",
        "teamLogoIcon": "string"
      }
    },
    "workingHours": {
      "additionalProp": {
        "createdAt": "string",
        "dateCreated": "string",
        "dateUpdated": "string",
        "description": "string",
        "entries": [
          {
            "id": 0,
            "meta": {},
            "type": "string"
          }
        ],
        "entryIds": [
          0
        ],
        "id": 0,
        "name": "string",
        "object": {
          "id": 0,
          "meta": {},
          "type": "string"
        },
        "objectId": 0,
        "objectType": "string",
        "updatedAt": "string"
      }
    }
  },
  "meta": {
    "averageSpend": 0,
    "limit": 0,
    "nextCursor": "string",
    "page": {
      "count": 0,
      "hasMore": true,
      "pageOffset": 0,
      "pageSize": 0
    },
    "prevCursor": "string",
    "totalCapacity": 0
  },
  "people": [
    {
      "avatarUrl": "string",
      "canAddProjects": true,
      "company": {
        "id": 0,
        "meta": {},
        "type": "string"
      },
      "companyId": 0,
      "companyRoleId": 0,
      "deleted": true,
      "email": "string",
      "firstName": "string",
      "id": 0,
      "isAdmin": true,
      "isClientUser": true,
      "isServiceAccount": true,
      "lastName": "string",
      "lengthOfDay": 0,
      "meta": {},
      "teams": [
        {
          "id": 0,
          "meta": {},
          "type": "string"
        }
      ],
      "timezone": "string",
      "title": "string",
      "type": "string",
      "userCost": 0,
      "userRate": 0,
      "workingHour": {
        "id": 0,
        "meta": {},
        "type": "string"
      },
      "workingHoursId": 0
    }
  ]
}