List of timesheets | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/timesheets"
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers)
print(response.json())

{
  "data": [
    {
      "id": "a3f1c9d2-4b7e-4f8a-9c3d-2e5b7f9a1c2d",
      "type": "work",
      "status": "approved",
      "contract": {
        "id": "c7d9e8f1-2a3b-4c5d-8e9f-0a1b2c3d4e5f",
        "type": "ongoing_time_based",
        "title": "Senior Software Engineer Contract"
      },
      "quantity": 8,
      "worksheet": {
        "days": 1,
        "hours": 4,
        "weeks": 0,
        "minutes": 30
      },
      "created_at": "2024-06-15T09:30:00Z",
      "description": "Timesheet for week 24, 2024",
      "reported_by": {
        "id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a",
        "full_name": "John Smith"
      },
      "total_amount": "1200.0000",
      "currency_code": "GBP",
      "date_submitted": "2024-06-22T10:00:00Z",
      "scale": "custom",
      "attachment": {
        "key": "timesheet-attachments/2024/06/15/a3f1c9d2-report.pdf",
        "filename": "June_Timesheet_Report.pdf"
      },
      "reviewed_by": {
        "id": "e7f8a9b0-c1d2-4e3f-8a9b-0c1d2e3f4a5b",
        "remarks": "Approved with no issues",
        "reviewed_at": "2024-06-16T14:45:00Z",
        "full_name": "Jane Smith"
      },
      "custom_scale": "hourly",
      "payment_cycle": {
        "end_date": "2024-06-21T23:59:59Z",
        "start_date": "2024-06-15T00:00:00Z"
      },
      "hourly_report_preset": {
        "id": "preset-12345",
        "rate": 150,
        "title": "Standard Hourly Rate",
        "description": "Standard hourly rate for software engineering tasks"
      }
    }
  ],
  "page": {
    "total_rows": 1
  }
}

Retrieve a list of timesheets in your Deel account. You can filter the list by providing additional paramters e.g. contract_id, contract_type etc. 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/

Query parameters

contract_idstringOptional

Id of an Deel contract.

contract_typeslist of enums or enumOptional

types of contracts to filter

statuseslist of enums or enumOptional

reporter_idstringOptionalformat: "uuid"

date_fromstringOptionalformat: "date"

date_tostringOptionalformat: "date"

limitstringOptionalformat: "^[0-9]+$"

offsetstringOptionalformat: "^[0-9]+$"

Response

Successful operation.

datalist of objects

pageobject

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

Authentication

Authentication

Query parameters

Response

Errors

Authentication