---
title: "List projects"
method: GET
path: "/v3/projects"
tags: ["Projects"]
---

# List projects

`GET /v3/projects`

Projects synced from the connected ERP (e.g. Sage Intacct). Can be populated on an obligation or billing term. A project may be tied to a single customer via customerId, or null for internal projects.

## Response `200`

Get projects

- object
  - `payload` object, required — Response payload, will be empty when success is false
    - `data` ProjectModelDto[]
      - `id` string, required — The ID of the project
      - `name` string, required — The name of the project
      - `fullName` string, required — The fully qualified name of the project
      - `externalId` string, required — The external ID of the project in the source ERP
      - `customerId` string, nullable, required — The ID of the Tabs customer this project is tied to, or null for internal/unassigned projects
  - `success` boolean, required — Boolean with true=success, false=failure
  - `message` string, required — Plain-text description of the result
  - `error` IntegratorsApiError, required
    - `code` number, required — API response code
    - `message` string, required — API response message
    - `details` object — Additional details about the error

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/revisions/7e8885517814/schema)