---
title: "List a project's notes"
method: GET
path: "/projects/{projectId}/notes"
tags: ["Projects"]
---

# List a project's notes

`GET /projects/{projectId}/notes`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/projects/{projectId}/notes`
- Auth: API key in header `X-Api-Key`

Returns the project's timeline notes (`projectNote` activities), newest first.

## Path parameters

- `projectId` string, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

A page of a project's notes

- object
  - `items` ProjectNote[], required
    - `id` string, uuid, required
    - `category` 'projectNote', required
    - `note` string, required: The note body (always present for projectNote activities created via this endpoint)
    - `projectId` string, uuid, required
    - `companyId` string, uuid, required
    - `createdByProfileId` string, uuid, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `metadata` ListMetadata, required: Paging block of the public API's list envelope.
    - `page` integer, required: Current page number (1-based)
    - `limit` integer, required: Number of items per page
    - `total` integer, required: Total number of matching items across all pages

## Other responses

- `400`: Invalid request — missing or malformed fields, unsupported mime type or fileType, or empty file.
- `404`: The specified resource was not found

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)