---
title: "Get all expenses on a workspace"
method: GET
path: "/v1/workspaces/{workspaceId}/expenses"
tags: ["Expense"]
---

# Get all expenses on a workspace

`GET /v1/workspaces/{workspaceId}/expenses`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Query parameters

- `page` integer — Page number.
- `page-size` integer — Page size.
- `user-id` string

## Response `200`

OK

- ExpensesAndTotalsDtoV1
  - `dailyTotals` ExpenseDailyTotalsDtoV1[] — Represents a list of expense daily total data transfer objects.
    - `date` string — Represents a date in yyyy-MM-dd format.
    - `dateAsInstant` string, date-time
    - `total` number, double — Represents expense total.
  - `expenses` ExpensesWithCountDtoV1 — Represents an expense with count data transfer object.
    - `count` integer — Represent result count.
    - `expenses` ExpenseHydratedDtoV1[] — Represent a list of hydrated expense objects.
      - `billable` boolean — Indicates whether expense is billable or not.
      - `category` ExpenseCategoryDto — Represents an expense category object.
        - `archived` boolean — Flag that indicates whether the expense category is archived or not.
        - `hasUnitPrice` boolean — Represents whether expense category has unit price or none.
        - `id` string — Represents expense category identifier across the system.
        - `name` string — Represents expense category name.
        - `priceInCents` integer — Represents price in cents as integer.
        - `unit` string — Represents expense category unit.
        - `workspaceId` string — Represents workspace identifier across the system.
      - `date` string — Represents a date in yyyy-MM-dd format.
      - `fileId` string — Represents file identifier across the system.
      - `fileName` string — Represents file name.
      - `id` string — Represents expense identifier across the system.
      - `isLocked` boolean
      - `locked` boolean
      - `notes` string — Represents notes for an expense.
      - `project` ProjectInfoDto — Represents a project info object.
        - `clientId` string — Represents client identifier across the system.
        - `clientName` string — Represents client name.
        - `color` string — Color format ^#(?:[0-9a-fA-F]{6}){1}$. Explanation: A valid color code should start with '#' and consist of six hexadecimal characters, representing a color in hexadecimal format. Color value is in standard RGB hexadecimal format.
        - `id` string — Represents project identifier across the system.
        - `name` string — Represents a project name.
      - `quantity` number, double — Represents expense quantity as double data type.
      - `task` TaskInfoDto — Represents a project info object.
        - `id` string — Represents task identifier across the system.
        - `name` string — Represents task name.
      - `total` number, double — Represents expense total as double data type.
      - `userId` string — Represents user identifier across the system.
      - `workspaceId` string — Represents workspace identifier across the system.
  - `weeklyTotals` ExpenseWeeklyTotalsDtoV1[] — Represents a list of expense weekly total data transfer objects.
    - `date` string — Represents a date in yyyy-MM-dd format.
    - `total` number, double — Represents expense total.

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)