---
title: "Get a list of company-owned projects"
method: GET
path: "/accounts/{account-id}/projects"
tags: ["Accounts"]
---

# Get a list of company-owned projects

`GET /accounts/{account-id}/projects`

## Request

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

Returns a list of projects owned by the company of the requesting user. Inactive projects are only returned if the requesting user is a Mendix Admin.</br>Every request must be authenticated through a Personal Access Token containing the `mx:app:metadata:read` scope.<br/>The result is sorted by the created date in descending order.

## Query parameters

- `createdSince` string

## Parameters

- `#components/parameters/limit` (unresolved $ref)
- `#components/parameters/offset` (unresolved $ref)
- `#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` object[]: Array of projects.
    - `projectId` string: Unique identifier for projects on the Mendix platform.
    - `name` string: Name of the project.
    - `description` string: Description of the project.
    - `logo` string: URL of the project image/logo.
    - `createdOn` string: Date and time in UTC when the project was created.
    - `active` boolean: Indicates whether a project is active or not. Inactive projects will only be returned to Mendix Admins.
    - `createdBy` object: Contains information about the person that created this project.
      - `userId` string: Unique identifier of the user on the Mendix platform.
      - `fullName` string: Full name of the member.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `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)