---
title: "Get a list of projects the user is a team member of"
method: GET
path: "/users/{user-id}/projects"
tags: ["Users"]
---

# Get a list of projects the user is a team member of

`GET /users/{user-id}/projects`

## Request

- Base URL: `https://projects-api.home.mendix.com/v2`
- URL: `https://projects-api.home.mendix.com/v2/users/{user-id}/projects`
- Auth: API key in header `Authorization`

Returns a list of projects that the specified user is a team member of. The output is restricted based on the authorization of the calling user. Mendix administrators will get a list of all projects (active or inactive) owned by their company for the specified user. This includes external users hired by them to work on their projects. Project members must be active and will get a list of all active projects that they themselves are a team member of. Project members cannot request a list of projects on behalf of someone else.<br/>The result is sorted alphabetically by project name in ascending order.</br>Every request must be authenticated through a Personal Access Token containing the `mx:app:metadata:read` scope.

## Path parameters

- `user-id` string, required

## Query parameters

- `permissions` string
- `isPinnedByUser` boolean
- `limit` integer
- `offset` integer

## Parameters

- `#components/parameters/categories` (unresolved $ref)

## Response `200`

List of projects

- object
  - `page` Page: Contains information about the current page, and the total number of elements to be retrieved.
    - `totalElements` integer: Total number of items to be expected
    - `offset` integer: Offset used by the current request
    - `elements` integer: Number of items in this current page
  - `links` PaginationLinks: Reusable pagination links object used in list responses.
    - `self` string, uri: URL of the current page of results.
    - `first` string, uri: URL of the first page of results.
    - `last` string, uri: URL of the last page of results.
    - `prev` string, uri: URL of the previous page of results, if any.
    - `next` string, uri: URL of the next page of results, if any.
  - `items` Project[]: Array of projects.
    - `projectId` string: Unique identifier for the project.
    - `name` string: Name of the project.
    - `description` string: Description of the project.
    - `logo` string: URL of the project image/logo.
    - `targetCloud` string: URL of the cloud portal the project is hosted on.
    - `active` boolean: Indicates whether a project is active and can be maintained by a team. Inactive projects will only be returned to Mendix Admins. Note this attribute does not indicate whether the project is actively deployed or running in the cloud.
    - `account` Account: Account or company that owns the resource
      - `accountId` string: Unique identifier of the account
      - `accountName` string: Name of the account

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/mendix/apis/projects-api.md) - [All operations](https://skmtc.dev/mendix/apis/projects-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/projects-api/revisions/3a958ca32c74?raw)