Deel: List of timesheets by contract — 200 response body — data item
List of timesheets by contract: 200 response body, field data / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: List of timesheets by contract — 200 response body — data item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
attachment | JSON | Optional | This object is used for linking file attachments to your records. |
attachment (anyOf 1) | Model | Alternative | Expand Attach a file to contract — 201 response body — data filename, key |
attachment (anyOf 2) | null | Alternative | |
contract | Model | Required within parent | Expand Retrieve a single timesheet entry — 200 response body — data contract Contract associated with this timesheet. |
created_at | string | Required within parent | Timestamp when the timesheet was created (ISO-8601). |
currency_code | JSON | Required within parent | |
currency_code (anyOf 1) | string | Alternative | ISO 4217 currency code used for the amount. Maximum length: 3 Minimum length: 3 Pattern: ^[A-Z]{3}$ |
currency_code (anyOf 2) | null | Alternative | ISO 4217 currency code used for the amount. Maximum length: 3 Minimum length: 3 Pattern: ^[A-Z]{3}$ |
custom_scale | JSON | Optional | |
custom_scale (anyOf 1) | string | Alternative | Custom scale label defined by the client for non-standard billing rates. |
custom_scale (anyOf 2) | null | Alternative | Custom scale label defined by the client for non-standard billing rates. |
date_submitted | JSON | Required within parent | |
date_submitted (anyOf 1) | string | Alternative | Timestamp when the timesheet was submitted for review (ISO-8601). Format: date-time |
date_submitted (anyOf 2) | null | Alternative | Timestamp when the timesheet was submitted for review (ISO-8601). Format: date-time |
description | string | Required within parent | Human-readable description of the work performed. |
hourly_report_preset | JSON | Optional | Timesheet preset linked to this entry, if any. |
hourly_report_preset (anyOf 1) | Model | Alternative | Expand List of timesheets — 200 response body — data item hourly report preset Timesheet preset linked to this entry, if any |
hourly_report_preset (anyOf 2) | null | Alternative | |
id | string | Required within parent | Unique identifier of this resource. Format: uuid |
payment_cycle | Model | Optional | Expand List of timesheets by contract — 200 response body — data item payment cycle Payment cycle associated with this timesheet. |
quantity | JSON | Required within parent | |
quantity (anyOf 1) | JSON | Alternative | |
quantity (anyOf 1) (anyOf 1) | number | Alternative | Quantity of work units (hours, days, etc.) used to calculate the total amount. Format: double |
quantity (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
quantity (anyOf 2) | null | Alternative | Quantity of work units (hours, days, etc.) used to calculate the total amount. Format: double |
reported_by | Model | Required within parent | Expand List of timesheets — 200 response body — data item reported by User who submitted the timesheet. |
reviewed_by | JSON | Optional | Reviewer information if the timesheet has been reviewed. |
reviewed_by (anyOf 1) | Model | Alternative | Expand List of timesheets by contract — 200 response body — data item reviewed by full name, id, remarks, reviewed at |
reviewed_by (anyOf 2) | null | Alternative | |
scale | JSON | Optional | |
scale (anyOf 1) | string | Alternative | Predefined scale used to calculate the timesheet amount (e.g. hourly, daily, custom). |
scale (anyOf 2) | null | Alternative | Predefined scale used to calculate the timesheet amount (e.g. hourly, daily, custom). |
status | JSON | Required within parent | Current processing status of the timesheet. |
status (anyOf 1) | string | Alternative | Current processing status of the timesheet. Known values: approved, declined, new, not_payable, paid, pending, processing |
status (anyOf 2) | null | Alternative | |
total_amount | string | Required within parent | Total monetary value equal to quantity times rate of active work statement plus any bonus. |
type | string | Required within parent | Deprecated - it is always “work” |
worksheet | JSON | Required within parent | Breakdown of time worked across different units. |
worksheet (anyOf 1) | Model | Alternative | Expand Retrieve a single timesheet entry — 200 response body — data worksheet Breakdown of time worked across different units |
worksheet (anyOf 2) | null | Alternative |
Referenced models: Attach a file to contract — 201 response body — data filename, key, List of timesheets — 200 response body — data item reported by, List of timesheets by contract — 200 response body — data item reviewed by full name, id, remarks, reviewed at, Retrieve a single timesheet entry — 200 response body — data worksheet Breakdown of time worked across different units, Retrieve a single timesheet entry — 200 response body — data contract, List of timesheets — 200 response body — data item hourly report preset Timesheet preset linked to this entry, if any, List of timesheets by contract — 200 response body — data item payment cycle