Retrieve a timesheet | Deel

curl -G https://api.letsdeel.com/rest/v2/time-tracking/timesheets/880e8400-e29b-41d4-a716-446655440003 \
     -H "Authorization: Bearer <token>" \
     -d extend=file_data

{
  "data": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "end_date": "2024-01-14",
    "created_at": "2024-01-15T09:15:00.000Z",
    "start_date": "2024-01-08",
    "updated_at": "2024-01-16T10:30:00.000Z",
    "contract_id": "mzz676x",
    "review_status": "PENDING_REVIEW",
    "submission_status": "SUBMITTED",
    "file_data": {
      "file_id": "770e8400-e29b-41d4-a716-446655440002",
      "file_name": "January_Week2_Timesheet.csv",
      "download_url": "https://my-unique-upload-bucket.s3.amazonaws.com/uploads/document.pdf?..."
    }
  }
}

Retrieves a timesheet by ID, including its submission, review, and processing status. When expand=file_data is provided, the response also includes file-related details such as the file name, download URL. Token scopes: time-tracking: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

timesheet_idstringRequiredformat: "uuid"

ID of the timesheet to fetch file for

Query parameters

extendstringOptional

Optional list of fields to extend in the response. Currently only file_data is supported, which includes file details (file_id, file_name) and download URL.

Response

Timesheet retrieved successfully. Returns timesheet details including validation errors if applicable. When extend=file_data, also includes file_data object with file details and download URL.

dataobject

Timesheet data including validation errors if applicable. When extend=file_data, also includes file_data object with file details and download URL.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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