---
title: "Get all projects for entity"
method: GET
path: "/projects"
tags: ["Projects"]
---

# Get all projects for entity

`GET /projects`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/projects`
- Auth: HTTP bearer

Get all projects for an entity

## Query parameters

- `order` 'asc' | 'desc'
- `limit` integer
- `pagination_token` string
- `sort` 'id' | 'created_at'
- `created_at__gt` string, date-time
- `created_at__lt` string, date-time
- `created_at__gte` string, date-time
- `created_at__lte` string, date-time
- `start_date` string, date
- `start_date__gt` string, date
- `start_date__lt` string, date
- `start_date__gte` string, date
- `start_date__lte` string, date
- `end_date` string, date
- `end_date__gt` string, date
- `end_date__lt` string, date
- `end_date__gte` string, date
- `end_date__lte` string, date
- `name` string
- `name__iexact` string
- `name__contains` string
- `name__icontains` string
- `code` string
- `created_by_entity_user_id` string, uuid

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Response `200`

Successful Response

- ProjectPaginationResponse: A paginated list of projects.
  - `data` ProjectResource[], required
    - `id` string, uuid, required: A unique ID assigned to this project.
    - `created_at` string, date-time, required: UTC date and time when this project was created.
    - `updated_at` string, date-time, required: UTC date and time when this project was last updated.
    - `code` string: A user-defined identifier of this project.
    - `color` string: Project color as a [CSS-compatible](https://developer.mozilla.org/en-US/docs/Web/CSS/color) value. Client applications can use this to color-code the projects or project-related data.
    - `created_by_entity_user_id` string, uuid: ID of the entity user who created this project, or `null` if it was created using a partner access token.
    - `description` string: A user-defined description of the project.
    - `end_date` string, date: Project end date.
    - `entity_id` string, uuid, required: ID of the entity that owns this project.
    - `name` string, required: The project name.
    - `parent_id` string, uuid: Unused. Reserved for future use.
    - `partner_metadata` object: [Metadata](https://docs.monite.com/common/metadata) for partner needs.
    - `start_date` string, date: Project start date.
    - `tags` TagReadSchema[]: A list of user-defined tags (labels) assigned to this project.
      - `id` string, uuid, required: A unique ID of this tag.
      - `created_at` string, date-time, required: Date and time when the tag was created. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
      - `updated_at` string, date-time, required: Date and time when the tag was last updated. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
      - `category` 'document_type' | 'department' | 'project' | 'cost_center' | 'vendor_type' | 'payment_method' | 'approval_status'
      - `created_by_entity_user_id` string, uuid: ID of the user who created the tag.
      - `description` string: The tag description.
      - `name` string, required: The tag name.
  - `next_pagination_token` string: A token that can be sent in the `pagination_token` query parameter to get the next page of results, or `null` if there is no next page (i.e. you've reached the last page).
  - `prev_pagination_token` string: A token that can be sent in the `pagination_token` query parameter to get the previous page of results, or `null` if there is no previous page (i.e. you've reached the first page).

## Other responses

- `400`: Bad Request
- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `403`: The specified access token does not have permissions to perform this operation.
- `404`: Not found
- `406`: Not Acceptable
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

[API](https://skmtc.dev/monite/apis/monite-2.md) - [All operations](https://skmtc.dev/monite/apis/monite-2/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-2/revisions/4299ccf95edb?raw)