Deel: Retrieve a timesheet — 200 response body — data

API reference · Contract 2026-10-27

SDK schema: Retrieve a timesheet — 200 response body — data

Field	Type	Presence	Description and constraints
$	object	Root	Timesheet data including validation errors if applicable. When extend=file_data, also includes file_data object with file details and download URL.
contract_id	string	Required within parent	External id of the worker’s contract associated with the timesheet
created_at	string	Required within parent	Timestamp when the timesheet was created Format: date-time
end_date	string	Required within parent	End date of the timesheet period Format: date
file_data	JSON	Optional	Present only when `extend=file_data` is provided. Contains file details and download URL.
file_data (anyOf 1)	Model	Alternative	Expand Retrieve a timesheet — 200 response body — data file data download url, file id, file name
file_data (anyOf 2)	null	Alternative
id	string	Required within parent	Unique identifier for the timesheet Format: uuid
review_status	string	Required within parent	Current status of the timesheet review Known values: PENDING_CREATION, PENDING_REVIEW, APPROVED, REJECTED
start_date	string	Required within parent	Start date of the timesheet period Format: date
submission_status	string	Required within parent	Current status of the timesheet submission Known values: UPLOADING, UPLOAD_FAILED, PROCESSING, SUBMITTED, INVALID, FAILED
updated_at	string	Required within parent	Timestamp when the timesheet was last updated Format: date-time
validation_errors	JSON	Required within parent
validation_errors (anyOf 1)	array	Alternative	Array of validation errors found during timesheet processing. Null if no errors found.
validation_errors (anyOf 1)[]	Model	Each item	Expand Retrieve a timesheet — 200 response body — data validation errors null item
validation_errors (anyOf 2)	null	Alternative	Array of validation errors found during timesheet processing. Null if no errors found.
validation_errors (anyOf 2)[]	Model	Each item	Expand Retrieve a timesheet — 200 response body — data validation errors null item

Referenced models: Retrieve a timesheet — 200 response body — data file data download url, file id, file name, Retrieve a timesheet — 200 response body — data validation errors null item