For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeel Home
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
  • Resources
    • Blog
    • Community
    • API spec
  • Contractors
    • Introduction
    • Invoice adjustments
    • Timesheets
  • Common Use Cases
    • Sign contracts and amendments in bulk
    • Give bonus to contractors
    • Reimburse contractor expenses
  • Endpoints
      • POSTCreate a timesheet entry
      • GETList of timesheets
      • GETList of timesheets by contract
      • GETRetrieve a single timesheet entry
      • POSTReview a single timesheet
      • PATCHUpdate a timesheet entry
LogoLogo
SupportDeel Home
EndpointsTimesheets

List of timesheets by contract

GET
/contracts/:contract_id/timesheets
GET
/rest/v2/contracts/:contract_id/timesheets
$curl -G https://api.letsdeel.com/rest/v2/contracts/c1e2e3l4/timesheets \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d contract_types=ongoing_time_based \
>     -d statuses=approved \
>     -d reporter_id=e1x2a3m4p5l6e7 \
>     -d date_from=2022-12-31 \
>     -d date_to=2022-12-31 \
>     -d limit=10 \
>     -d offset=10
1{
2  "data": [
3    {
4      "id": "a3f1c2d4-5678-4e9b-9f12-3456789abcde",
5      "type": "work",
6      "status": "approved",
7      "contract": {
8        "id": "c1e2e3l4",
9        "type": "ongoing_time_based",
10        "title": "Software Development Contract"
11      },
12      "quantity": 38.5,
13      "worksheet": {
14        "days": 5,
15        "hours": 38,
16        "weeks": 1,
17        "minutes": 30
18      },
19      "created_at": "2024-01-15T09:30:00Z",
20      "description": "Timesheet for week 2 of January 2024",
21      "reported_by": {
22        "id": "b7d9e8f0-1234-4abc-9def-56789abcdef0",
23        "full_name": "Jane Doe"
24      },
25      "total_amount": "3850.00",
26      "currency_code": "USD",
27      "date_submitted": "2024-01-15T09:30:00Z",
28      "scale": "hourly",
29      "attachment": {
30        "key": "timesheet-attachments/2024/01/15/a3f1c2d4-5678-4e9b-9f12-3456789abcde.pdf",
31        "filename": "timesheet_january_15.pdf"
32      },
33      "reviewed_by": {
34        "id": "c9e8f7a6-4321-4def-8abc-09876fedcba0",
35        "remarks": "Approved without issues",
36        "reviewed_at": "2024-01-16T14:00:00Z",
37        "full_name": "John Smith"
38      },
39      "custom_scale": null,
40      "payment_cycle": {
41        "end_date": "2024-01-15T23:59:59Z",
42        "start_date": "2024-01-09T00:00:00Z"
43      },
44      "hourly_report_preset": {
45        "id": "preset-1234",
46        "rate": 100,
47        "title": "Standard Developer Rate",
48        "description": "Hourly rate for software development tasks"
49      }
50    }
51  ],
52  "page": {
53    "total_rows": 100
54  }
55}

Returns timesheets associated with the specified contract, with optional filtering by contract type, status, reporter, and date range. Token scopes: timesheets:read

Was this page helpful?
Previous

Retrieve a single timesheet entry

Next
Built with

Authentication

AuthorizationBearer
## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
OR
AuthorizationBearer
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

contract_idstringRequired
Deel contract id.

Query parameters

contract_typeslist of enums or enumOptional
Types of contracts to filter.
statuseslist of enums or enumOptional
Statuses of timesheets to filter.
reporter_idstringOptionalformat: "uuid"
ID of an existing profile
date_fromstringOptionalformat: "date"

Filtered results will include records created on or after the provided date. Short date in format ISO-8601 (YYYY-MM-DD). For example: 2022-12-31.

date_tostringOptionalformat: "date"

Filtered results will include records created before the provided date. Short date in format ISO-8601 (YYYY-MM-DD). For example: 2022-12-31.

limitstringOptional

Return a page of results with given number of records; NOTE: technically ALL query parameters are strings or array of strings

offsetstringOptional
Return a page of results after given index of row

Response

Successful operation.
datalist of objects
pageobject
This object is used for pagination.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/