---
title: "List timesheets"
method: GET
path: "/timesheets"
tags: ["Timesheets"]
---

# List timesheets

`GET /timesheets`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/timesheets`
- Auth: HTTP bearer

Returns a list of timesheets.

## Query parameters

- `startingAfter` string
- `endingBefore` string
- `limit` integer
- `memberId` string
- `start` string
- `startOnAfter` string
- `startOnBefore` string
- `end` string
- `endOnAfter` string
- `endOnBefore` string

## Response `200`

200

- object
  - `results` Timesheet[]: The list of results for the current page.
    - `id` string: The unique identifier for the object.
    - `start` string, date: The start date of the timesheet period. Will be in the form YYYY-MM-DD.
    - `end` string, date: The end date of the timesheet period. Will be in the form YYYY-MM-DD.
    - `createdAt` string, date-time: The timestamp when the object was created.
    - `submittedOn` string, date-time: The timestamp when the timesheet was submitted.
    - `hours` number: The total number of hours tracked in this timesheet period.
    - `attestationText` string, nullable: The statement the member attested to when the timesheet was submitted. `null` when no attestation was captured.
    - `attestationSignature` string, nullable: The signature the member provided when attesting to the timesheet. `null` when no attestation was captured.
    - `member` object: The member this timesheet was submitted for.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the member.
    - `timeEntries` object[]: The time entries included in this timesheet.
      - `id` string: The unique identifier for the object.
      - `minutes` integer: The duration of the time entry in minutes.
    - `submittedByMember` object, nullable: The member who submitted the timesheet. This is the timesheet's own `member` when they submitted it themselves, and a different member when someone submitted on their behalf. `null` when the timesheet was submitted through the API, submitted automatically on a schedule, or submitted before this field was introduced.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the member.
    - `attested` boolean: Whether the timesheet was attested. This is a calculated value based on whether an `attestationSignature` was captured.
  - `hasMore` boolean: Whether there are more results available after this page.

## Other responses

- `400`: 400
- `403`: 403

---

[API](https://skmtc.dev/ruddr/apis/ruddr-api.md) · [All operations](https://skmtc.dev/ruddr/apis/ruddr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruddr/apis/ruddr-api/revisions/01c3f2a969ba?raw)