List of timesheets by contract | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/contracts/c1e2e3l4/timesheets"
querystring = {"contract_types":"[\"ongoing_time_based\"]","statuses":"[\"approved\"]","reporter_id":"e1x2a3m4p5l6e7","date_from":"2022-12-31","date_to":"2022-12-31","limit":"10","offset":"10"}
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers, params=querystring)
print(response.json())

{
  "data": [
    {
      "id": "a3f1c2d4-5678-4e9b-9f12-3456789abcde",
      "type": "work",
      "status": "approved",
      "contract": {
        "id": "c1e2e3l4",
        "type": "ongoing_time_based",
        "title": "Software Development Contract"
      },
      "quantity": 38.5,
      "worksheet": {
        "days": 5,
        "hours": 38,
        "weeks": 1,
        "minutes": 30
      },
      "created_at": "2024-01-15T09:30:00Z",
      "description": "Timesheet for week 2 of January 2024",
      "reported_by": {
        "id": "b7d9e8f0-1234-4abc-9def-56789abcdef0",
        "full_name": "Jane Doe"
      },
      "total_amount": "3850.00",
      "currency_code": "USD",
      "date_submitted": "2024-01-15T09:30:00Z",
      "scale": "hourly",
      "attachment": {
        "key": "timesheet-attachments/2024/01/15/a3f1c2d4-5678-4e9b-9f12-3456789abcde.pdf",
        "filename": "timesheet_january_15.pdf"
      },
      "reviewed_by": {
        "id": "c9e8f7a6-4321-4def-8abc-09876fedcba0",
        "remarks": "Approved without issues",
        "reviewed_at": "2024-01-16T14:00:00Z",
        "full_name": "John Smith"
      },
      "payment_cycle": {
        "end_date": "2024-01-15T23:59:59Z",
        "start_date": "2024-01-09T00:00:00Z"
      },
      "hourly_report_preset": {
        "id": "preset-1234",
        "rate": 100,
        "title": "Standard Developer Rate",
        "description": "Hourly rate for software development tasks"
      }
    }
  ],
  "page": {
    "total_rows": 100
  }
}

Retrieve a list of timesheets found for a contract. Token scopes: timesheets:read

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.

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

Learn more about authentication

## 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)

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.

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

Authentication

Authentication

Path parameters

Query parameters

Response

Errors

Authentication