TimesheetSubmissions hold a set of time entries for a specified week, and can be approved, rejected, or canceled. You can enable Timesheet submissions and approval in your project settings. Once enabled, time entries must be approved through a TimesheetSubmission before it is invoiceable.
Note: Each TimesheetSubmission can only be associated with a single project. So when a timesheet is submitted through the UI with time entries for multiple projects, a separate TimesheetSubmission object is created for each project in the backend.
This endpoint returns structured Timesheet Submission objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the timesheet_submissions
top-level JSON key.
Please see our Response Format section for more information.
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "timesheet_submissions": {
- "property1": {
- "comment": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_resolution_created_at_date": "2019-08-24T14:15:22Z",
- "current_resolution_creator_id": 0,
- "current_resolution_description": "string",
- "end_date": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "line_item_total_formatted": "string",
- "line_item_total_in_cents": 0,
- "permissions": {
- "can_cancel_submission": true,
- "can_approve_submission": true,
- "can_reject_submission": true,
- "can_resubmit_submission": true
}, - "resolution_description": "string",
- "start_date": "2019-08-24",
- "status": "string",
- "time_entry_ids": [
- "string"
], - "title": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": "string",
- "workspace_id": "string"
}, - "property2": {
- "comment": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_resolution_created_at_date": "2019-08-24T14:15:22Z",
- "current_resolution_creator_id": 0,
- "current_resolution_description": "string",
- "end_date": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "line_item_total_formatted": "string",
- "line_item_total_in_cents": 0,
- "permissions": {
- "can_cancel_submission": true,
- "can_approve_submission": true,
- "can_reject_submission": true,
- "can_resubmit_submission": true
}, - "resolution_description": "string",
- "start_date": "2019-08-24",
- "status": "string",
- "time_entry_ids": [
- "string"
], - "title": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": "string",
- "workspace_id": "string"
}
}, - "external_references": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "external_link": "string",
- "external_message": "string",
- "external_status": "string",
- "last_synced_at": "2019-08-24T14:15:22Z",
- "locked": true,
- "service_model": "string",
- "service_model_ref": "string",
- "service_name": "string",
- "status": "string",
- "subject_id": 0,
- "subject_ref": {
- "key": "string",
- "id": "string"
}, - "subject_type": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "external_link": "string",
- "external_message": "string",
- "external_status": "string",
- "last_synced_at": "2019-08-24T14:15:22Z",
- "locked": true,
- "service_model": "string",
- "service_model_ref": "string",
- "service_name": "string",
- "status": "string",
- "subject_id": 0,
- "subject_ref": {
- "key": "string",
- "id": "string"
}, - "subject_type": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}, - "users": {
- "property1": {
- "abbreviated_timezone": "string",
- "account_membership_id": "string",
- "bio": "string",
- "city": "string",
- "classification": "string",
- "country": "string",
- "custom_field_value_ids": [
- "string"
], - "email_address": "string",
- "external_reference_ids": [
- "string"
], - "full_name": "string",
- "headline": "string",
- "last_site_activity": "2019-08-24T14:15:22Z",
- "photo_path": "string",
- "role_id": "string",
- "skill_ids": [
- "string"
], - "skill_membership_ids": [
- "string"
], - "state": "string",
- "website": "string",
- "work_sample_ids": [
- "string"
]
}, - "property2": {
- "abbreviated_timezone": "string",
- "account_membership_id": "string",
- "bio": "string",
- "city": "string",
- "classification": "string",
- "country": "string",
- "custom_field_value_ids": [
- "string"
], - "email_address": "string",
- "external_reference_ids": [
- "string"
], - "full_name": "string",
- "headline": "string",
- "last_site_activity": "2019-08-24T14:15:22Z",
- "photo_path": "string",
- "role_id": "string",
- "skill_ids": [
- "string"
], - "skill_membership_ids": [
- "string"
], - "state": "string",
- "website": "string",
- "work_sample_ids": [
- "string"
]
}
}, - "workspaces": {
- "property1": {
- "access_level": "string",
- "account_color_id": "string",
- "account_features": {
- "time_trackable": true,
- "has_time_entry_role_picker": true,
- "project_side_panel": true
}, - "account_id": 0,
- "approver_id": "string",
- "approver_ids": [
- "string"
], - "archived": true,
- "billable_minutes": 0,
- "budget_remaining": "string",
- "budget_used": "string",
- "budget_used_in_cents": 0,
- "budgeted": true,
- "can_create_line_items": true,
- "can_invite": true,
- "change_orders_enabled": true,
- "client_lead_name": "string",
- "client_role_name": "string",
- "consultant_role_name": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "creator_id": "string",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_status_report_id": "string",
- "current_user_participation_id": "string",
- "custom_field_value_ids": [
- "string"
], - "default_rate": "string",
- "description": "string",
- "due_date": "2019-08-24",
- "effective_due_date": "2019-08-24",
- "estimated_minutes": 0,
- "exclude_archived_stories_percent_complete": true,
- "expenses_in_burn_rate": true,
- "external_reference_ids": [
- "string"
], - "financial_viewer_ids": [
- "string"
], - "has_active_expense_report_submissions": true,
- "has_active_timesheet_submissions": true,
- "has_budget_access": true,
- "lock_date": "2019-08-24",
- "minutes_logged": 0,
- "next_uncompleted_milestone_id": "string",
- "non_billable_minutes": 0,
- "over_budget": true,
- "participant_ids": [
- "string"
], - "participation_ids": [
- "string"
], - "percent_of_budget_used": 0,
- "percentage_complete": 0,
- "permissions": {
- "can_upload_files": true,
- "can_private_message": true,
- "can_join": true,
- "is_participant": true,
- "access_level": "string",
- "team_lead": true,
- "user_is_client": true,
- "can_change_price": true,
- "can_change_story_billable": true,
- "can_post": true,
- "can_edit": true,
- "restricted": true,
- "can_see_financials": true,
- "is_guest_on_project": true
}, - "possible_approver_ids": [
- "string"
], - "posts_require_privacy_decision": true,
- "price": "string",
- "price_in_cents": 0,
- "primary_counterpart_id": "string",
- "primary_maven_id": "string",
- "primary_workspace_group_id": "string",
- "provider_lead_name": "string",
- "rate_card_id": 0,
- "require_expense_approvals": true,
- "require_time_approvals": true,
- "stage": "string",
- "start_date": "2019-08-24",
- "status": {
- "color": "string",
- "key": "string",
- "message": "string"
}, - "status_report_ids": [
- "string"
], - "stories_are_fixed_fee_by_default": true,
- "target_margin": 0,
- "tasks_default_non_billable": true,
- "timesheet_submission_ids": [
- "string"
], - "title": "string",
- "total_expenses_in_cents": 0,
- "total_invoiced": "string",
- "total_minutes_approved": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "workspace_group_ids": [
- "string"
], - "workspace_invoice_preference_id": 0,
- "workspace_resource_ids": [
- "string"
], - "workspace_resources_with_unnamed_ids": [
- "string"
]
}, - "property2": {
- "access_level": "string",
- "account_color_id": "string",
- "account_features": {
- "time_trackable": true,
- "has_time_entry_role_picker": true,
- "project_side_panel": true
}, - "account_id": 0,
- "approver_id": "string",
- "approver_ids": [
- "string"
], - "archived": true,
- "billable_minutes": 0,
- "budget_remaining": "string",
- "budget_used": "string",
- "budget_used_in_cents": 0,
- "budgeted": true,
- "can_create_line_items": true,
- "can_invite": true,
- "change_orders_enabled": true,
- "client_lead_name": "string",
- "client_role_name": "string",
- "consultant_role_name": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "creator_id": "string",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_status_report_id": "string",
- "current_user_participation_id": "string",
- "custom_field_value_ids": [
- "string"
], - "default_rate": "string",
- "description": "string",
- "due_date": "2019-08-24",
- "effective_due_date": "2019-08-24",
- "estimated_minutes": 0,
- "exclude_archived_stories_percent_complete": true,
- "expenses_in_burn_rate": true,
- "external_reference_ids": [
- "string"
], - "financial_viewer_ids": [
- "string"
], - "has_active_expense_report_submissions": true,
- "has_active_timesheet_submissions": true,
- "has_budget_access": true,
- "lock_date": "2019-08-24",
- "minutes_logged": 0,
- "next_uncompleted_milestone_id": "string",
- "non_billable_minutes": 0,
- "over_budget": true,
- "participant_ids": [
- "string"
], - "participation_ids": [
- "string"
], - "percent_of_budget_used": 0,
- "percentage_complete": 0,
- "permissions": {
- "can_upload_files": true,
- "can_private_message": true,
- "can_join": true,
- "is_participant": true,
- "access_level": "string",
- "team_lead": true,
- "user_is_client": true,
- "can_change_price": true,
- "can_change_story_billable": true,
- "can_post": true,
- "can_edit": true,
- "restricted": true,
- "can_see_financials": true,
- "is_guest_on_project": true
}, - "possible_approver_ids": [
- "string"
], - "posts_require_privacy_decision": true,
- "price": "string",
- "price_in_cents": 0,
- "primary_counterpart_id": "string",
- "primary_maven_id": "string",
- "primary_workspace_group_id": "string",
- "provider_lead_name": "string",
- "rate_card_id": 0,
- "require_expense_approvals": true,
- "require_time_approvals": true,
- "stage": "string",
- "start_date": "2019-08-24",
- "status": {
- "color": "string",
- "key": "string",
- "message": "string"
}, - "status_report_ids": [
- "string"
], - "stories_are_fixed_fee_by_default": true,
- "target_margin": 0,
- "tasks_default_non_billable": true,
- "timesheet_submission_ids": [
- "string"
], - "title": "string",
- "total_expenses_in_cents": 0,
- "total_invoiced": "string",
- "total_minutes_approved": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "workspace_group_ids": [
- "string"
], - "workspace_invoice_preference_id": 0,
- "workspace_resource_ids": [
- "string"
], - "workspace_resources_with_unnamed_ids": [
- "string"
]
}
}, - "time_entries": {
- "property1": {
- "active_submission_id": "string",
- "approved": true,
- "billable": true,
- "cost_rate_in_cents": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "date_performed": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "invoice_id": "string",
- "is_invoiced": true,
- "location": "string",
- "notes": "string",
- "rate_in_cents": 0,
- "recent_submission_id": "string",
- "role_id": "string",
- "story_id": "string",
- "taxable": true,
- "time_in_minutes": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "user_can_edit": true,
- "user_id": "string",
- "workspace_id": "string"
}, - "property2": {
- "active_submission_id": "string",
- "approved": true,
- "billable": true,
- "cost_rate_in_cents": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "date_performed": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "invoice_id": "string",
- "is_invoiced": true,
- "location": "string",
- "notes": "string",
- "rate_in_cents": 0,
- "recent_submission_id": "string",
- "role_id": "string",
- "story_id": "string",
- "taxable": true,
- "time_in_minutes": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "user_can_edit": true,
- "user_id": "string",
- "workspace_id": "string"
}
}
}
Create a new TimesheetSubmission.
Note: Only 1 TimesheetSubmission can be created per project."
This endpoint returns structured Timesheet Submission objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the timesheet_submissions
top-level JSON key.
Please see our Response Format section for more information.
{- "timesheet_submission": {
- "line_item_ids": [
- 0
], - "user_id": 0,
- "title": "string",
- "workspace_id": 0,
- "comment": "string",
- "external_reference": {
- "service_name": "string",
- "service_model": "string",
- "service_model_ref": "string",
- "status": "string",
- "external_message": "string",
- "external_link": "string",
- "external_status": "string",
- "locked": true
}
}
}
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "timesheet_submissions": {
- "property1": {
- "comment": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_resolution_created_at_date": "2019-08-24T14:15:22Z",
- "current_resolution_creator_id": 0,
- "current_resolution_description": "string",
- "end_date": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "line_item_total_formatted": "string",
- "line_item_total_in_cents": 0,
- "permissions": {
- "can_cancel_submission": true,
- "can_approve_submission": true,
- "can_reject_submission": true,
- "can_resubmit_submission": true
}, - "resolution_description": "string",
- "start_date": "2019-08-24",
- "status": "string",
- "time_entry_ids": [
- "string"
], - "title": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": "string",
- "workspace_id": "string"
}, - "property2": {
- "comment": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_resolution_created_at_date": "2019-08-24T14:15:22Z",
- "current_resolution_creator_id": 0,
- "current_resolution_description": "string",
- "end_date": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "line_item_total_formatted": "string",
- "line_item_total_in_cents": 0,
- "permissions": {
- "can_cancel_submission": true,
- "can_approve_submission": true,
- "can_reject_submission": true,
- "can_resubmit_submission": true
}, - "resolution_description": "string",
- "start_date": "2019-08-24",
- "status": "string",
- "time_entry_ids": [
- "string"
], - "title": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": "string",
- "workspace_id": "string"
}
}, - "external_references": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "external_link": "string",
- "external_message": "string",
- "external_status": "string",
- "last_synced_at": "2019-08-24T14:15:22Z",
- "locked": true,
- "service_model": "string",
- "service_model_ref": "string",
- "service_name": "string",
- "status": "string",
- "subject_id": 0,
- "subject_ref": {
- "key": "string",
- "id": "string"
}, - "subject_type": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "external_link": "string",
- "external_message": "string",
- "external_status": "string",
- "last_synced_at": "2019-08-24T14:15:22Z",
- "locked": true,
- "service_model": "string",
- "service_model_ref": "string",
- "service_name": "string",
- "status": "string",
- "subject_id": 0,
- "subject_ref": {
- "key": "string",
- "id": "string"
}, - "subject_type": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}, - "users": {
- "property1": {
- "abbreviated_timezone": "string",
- "account_membership_id": "string",
- "bio": "string",
- "city": "string",
- "classification": "string",
- "country": "string",
- "custom_field_value_ids": [
- "string"
], - "email_address": "string",
- "external_reference_ids": [
- "string"
], - "full_name": "string",
- "headline": "string",
- "last_site_activity": "2019-08-24T14:15:22Z",
- "photo_path": "string",
- "role_id": "string",
- "skill_ids": [
- "string"
], - "skill_membership_ids": [
- "string"
], - "state": "string",
- "website": "string",
- "work_sample_ids": [
- "string"
]
}, - "property2": {
- "abbreviated_timezone": "string",
- "account_membership_id": "string",
- "bio": "string",
- "city": "string",
- "classification": "string",
- "country": "string",
- "custom_field_value_ids": [
- "string"
], - "email_address": "string",
- "external_reference_ids": [
- "string"
], - "full_name": "string",
- "headline": "string",
- "last_site_activity": "2019-08-24T14:15:22Z",
- "photo_path": "string",
- "role_id": "string",
- "skill_ids": [
- "string"
], - "skill_membership_ids": [
- "string"
], - "state": "string",
- "website": "string",
- "work_sample_ids": [
- "string"
]
}
}, - "workspaces": {
- "property1": {
- "access_level": "string",
- "account_color_id": "string",
- "account_features": {
- "time_trackable": true,
- "has_time_entry_role_picker": true,
- "project_side_panel": true
}, - "account_id": 0,
- "approver_id": "string",
- "approver_ids": [
- "string"
], - "archived": true,
- "billable_minutes": 0,
- "budget_remaining": "string",
- "budget_used": "string",
- "budget_used_in_cents": 0,
- "budgeted": true,
- "can_create_line_items": true,
- "can_invite": true,
- "change_orders_enabled": true,
- "client_lead_name": "string",
- "client_role_name": "string",
- "consultant_role_name": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "creator_id": "string",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_status_report_id": "string",
- "current_user_participation_id": "string",
- "custom_field_value_ids": [
- "string"
], - "default_rate": "string",
- "description": "string",
- "due_date": "2019-08-24",
- "effective_due_date": "2019-08-24",
- "estimated_minutes": 0,
- "exclude_archived_stories_percent_complete": true,
- "expenses_in_burn_rate": true,
- "external_reference_ids": [
- "string"
], - "financial_viewer_ids": [
- "string"
], - "has_active_expense_report_submissions": true,
- "has_active_timesheet_submissions": true,
- "has_budget_access": true,
- "lock_date": "2019-08-24",
- "minutes_logged": 0,
- "next_uncompleted_milestone_id": "string",
- "non_billable_minutes": 0,
- "over_budget": true,
- "participant_ids": [
- "string"
], - "participation_ids": [
- "string"
], - "percent_of_budget_used": 0,
- "percentage_complete": 0,
- "permissions": {
- "can_upload_files": true,
- "can_private_message": true,
- "can_join": true,
- "is_participant": true,
- "access_level": "string",
- "team_lead": true,
- "user_is_client": true,
- "can_change_price": true,
- "can_change_story_billable": true,
- "can_post": true,
- "can_edit": true,
- "restricted": true,
- "can_see_financials": true,
- "is_guest_on_project": true
}, - "possible_approver_ids": [
- "string"
], - "posts_require_privacy_decision": true,
- "price": "string",
- "price_in_cents": 0,
- "primary_counterpart_id": "string",
- "primary_maven_id": "string",
- "primary_workspace_group_id": "string",
- "provider_lead_name": "string",
- "rate_card_id": 0,
- "require_expense_approvals": true,
- "require_time_approvals": true,
- "stage": "string",
- "start_date": "2019-08-24",
- "status": {
- "color": "string",
- "key": "string",
- "message": "string"
}, - "status_report_ids": [
- "string"
], - "stories_are_fixed_fee_by_default": true,
- "target_margin": 0,
- "tasks_default_non_billable": true,
- "timesheet_submission_ids": [
- "string"
], - "title": "string",
- "total_expenses_in_cents": 0,
- "total_invoiced": "string",
- "total_minutes_approved": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "workspace_group_ids": [
- "string"
], - "workspace_invoice_preference_id": 0,
- "workspace_resource_ids": [
- "string"
], - "workspace_resources_with_unnamed_ids": [
- "string"
]
}, - "property2": {
- "access_level": "string",
- "account_color_id": "string",
- "account_features": {
- "time_trackable": true,
- "has_time_entry_role_picker": true,
- "project_side_panel": true
}, - "account_id": 0,
- "approver_id": "string",
- "approver_ids": [
- "string"
], - "archived": true,
- "billable_minutes": 0,
- "budget_remaining": "string",
- "budget_used": "string",
- "budget_used_in_cents": 0,
- "budgeted": true,
- "can_create_line_items": true,
- "can_invite": true,
- "change_orders_enabled": true,
- "client_lead_name": "string",
- "client_role_name": "string",
- "consultant_role_name": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "creator_id": "string",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_status_report_id": "string",
- "current_user_participation_id": "string",
- "custom_field_value_ids": [
- "string"
], - "default_rate": "string",
- "description": "string",
- "due_date": "2019-08-24",
- "effective_due_date": "2019-08-24",
- "estimated_minutes": 0,
- "exclude_archived_stories_percent_complete": true,
- "expenses_in_burn_rate": true,
- "external_reference_ids": [
- "string"
], - "financial_viewer_ids": [
- "string"
], - "has_active_expense_report_submissions": true,
- "has_active_timesheet_submissions": true,
- "has_budget_access": true,
- "lock_date": "2019-08-24",
- "minutes_logged": 0,
- "next_uncompleted_milestone_id": "string",
- "non_billable_minutes": 0,
- "over_budget": true,
- "participant_ids": [
- "string"
], - "participation_ids": [
- "string"
], - "percent_of_budget_used": 0,
- "percentage_complete": 0,
- "permissions": {
- "can_upload_files": true,
- "can_private_message": true,
- "can_join": true,
- "is_participant": true,
- "access_level": "string",
- "team_lead": true,
- "user_is_client": true,
- "can_change_price": true,
- "can_change_story_billable": true,
- "can_post": true,
- "can_edit": true,
- "restricted": true,
- "can_see_financials": true,
- "is_guest_on_project": true
}, - "possible_approver_ids": [
- "string"
], - "posts_require_privacy_decision": true,
- "price": "string",
- "price_in_cents": 0,
- "primary_counterpart_id": "string",
- "primary_maven_id": "string",
- "primary_workspace_group_id": "string",
- "provider_lead_name": "string",
- "rate_card_id": 0,
- "require_expense_approvals": true,
- "require_time_approvals": true,
- "stage": "string",
- "start_date": "2019-08-24",
- "status": {
- "color": "string",
- "key": "string",
- "message": "string"
}, - "status_report_ids": [
- "string"
], - "stories_are_fixed_fee_by_default": true,
- "target_margin": 0,
- "tasks_default_non_billable": true,
- "timesheet_submission_ids": [
- "string"
], - "title": "string",
- "total_expenses_in_cents": 0,
- "total_invoiced": "string",
- "total_minutes_approved": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "workspace_group_ids": [
- "string"
], - "workspace_invoice_preference_id": 0,
- "workspace_resource_ids": [
- "string"
], - "workspace_resources_with_unnamed_ids": [
- "string"
]
}
}, - "time_entries": {
- "property1": {
- "active_submission_id": "string",
- "approved": true,
- "billable": true,
- "cost_rate_in_cents": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "date_performed": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "invoice_id": "string",
- "is_invoiced": true,
- "location": "string",
- "notes": "string",
- "rate_in_cents": 0,
- "recent_submission_id": "string",
- "role_id": "string",
- "story_id": "string",
- "taxable": true,
- "time_in_minutes": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "user_can_edit": true,
- "user_id": "string",
- "workspace_id": "string"
}, - "property2": {
- "active_submission_id": "string",
- "approved": true,
- "billable": true,
- "cost_rate_in_cents": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "date_performed": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "invoice_id": "string",
- "is_invoiced": true,
- "location": "string",
- "notes": "string",
- "rate_in_cents": 0,
- "recent_submission_id": "string",
- "role_id": "string",
- "story_id": "string",
- "taxable": true,
- "time_in_minutes": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "user_can_edit": true,
- "user_id": "string",
- "workspace_id": "string"
}
}
}
This endpoint returns structured Timesheet Submission objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the timesheet_submissions
top-level JSON key.
Please see our Response Format section for more information.
include | string Any of the below associations can be included in your request by providing the
|
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "timesheet_submissions": {
- "property1": {
- "comment": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_resolution_created_at_date": "2019-08-24T14:15:22Z",
- "current_resolution_creator_id": 0,
- "current_resolution_description": "string",
- "end_date": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "line_item_total_formatted": "string",
- "line_item_total_in_cents": 0,
- "permissions": {
- "can_cancel_submission": true,
- "can_approve_submission": true,
- "can_reject_submission": true,
- "can_resubmit_submission": true
}, - "resolution_description": "string",
- "start_date": "2019-08-24",
- "status": "string",
- "time_entry_ids": [
- "string"
], - "title": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": "string",
- "workspace_id": "string"
}, - "property2": {
- "comment": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_resolution_created_at_date": "2019-08-24T14:15:22Z",
- "current_resolution_creator_id": 0,
- "current_resolution_description": "string",
- "end_date": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "line_item_total_formatted": "string",
- "line_item_total_in_cents": 0,
- "permissions": {
- "can_cancel_submission": true,
- "can_approve_submission": true,
- "can_reject_submission": true,
- "can_resubmit_submission": true
}, - "resolution_description": "string",
- "start_date": "2019-08-24",
- "status": "string",
- "time_entry_ids": [
- "string"
], - "title": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": "string",
- "workspace_id": "string"
}
}, - "external_references": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "external_link": "string",
- "external_message": "string",
- "external_status": "string",
- "last_synced_at": "2019-08-24T14:15:22Z",
- "locked": true,
- "service_model": "string",
- "service_model_ref": "string",
- "service_name": "string",
- "status": "string",
- "subject_id": 0,
- "subject_ref": {
- "key": "string",
- "id": "string"
}, - "subject_type": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "external_link": "string",
- "external_message": "string",
- "external_status": "string",
- "last_synced_at": "2019-08-24T14:15:22Z",
- "locked": true,
- "service_model": "string",
- "service_model_ref": "string",
- "service_name": "string",
- "status": "string",
- "subject_id": 0,
- "subject_ref": {
- "key": "string",
- "id": "string"
}, - "subject_type": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}, - "users": {
- "property1": {
- "abbreviated_timezone": "string",
- "account_membership_id": "string",
- "bio": "string",
- "city": "string",
- "classification": "string",
- "country": "string",
- "custom_field_value_ids": [
- "string"
], - "email_address": "string",
- "external_reference_ids": [
- "string"
], - "full_name": "string",
- "headline": "string",
- "last_site_activity": "2019-08-24T14:15:22Z",
- "photo_path": "string",
- "role_id": "string",
- "skill_ids": [
- "string"
], - "skill_membership_ids": [
- "string"
], - "state": "string",
- "website": "string",
- "work_sample_ids": [
- "string"
]
}, - "property2": {
- "abbreviated_timezone": "string",
- "account_membership_id": "string",
- "bio": "string",
- "city": "string",
- "classification": "string",
- "country": "string",
- "custom_field_value_ids": [
- "string"
], - "email_address": "string",
- "external_reference_ids": [
- "string"
], - "full_name": "string",
- "headline": "string",
- "last_site_activity": "2019-08-24T14:15:22Z",
- "photo_path": "string",
- "role_id": "string",
- "skill_ids": [
- "string"
], - "skill_membership_ids": [
- "string"
], - "state": "string",
- "website": "string",
- "work_sample_ids": [
- "string"
]
}
}, - "workspaces": {
- "property1": {
- "access_level": "string",
- "account_color_id": "string",
- "account_features": {
- "time_trackable": true,
- "has_time_entry_role_picker": true,
- "project_side_panel": true
}, - "account_id": 0,
- "approver_id": "string",
- "approver_ids": [
- "string"
], - "archived": true,
- "billable_minutes": 0,
- "budget_remaining": "string",
- "budget_used": "string",
- "budget_used_in_cents": 0,
- "budgeted": true,
- "can_create_line_items": true,
- "can_invite": true,
- "change_orders_enabled": true,
- "client_lead_name": "string",
- "client_role_name": "string",
- "consultant_role_name": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "creator_id": "string",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_status_report_id": "string",
- "current_user_participation_id": "string",
- "custom_field_value_ids": [
- "string"
], - "default_rate": "string",
- "description": "string",
- "due_date": "2019-08-24",
- "effective_due_date": "2019-08-24",
- "estimated_minutes": 0,
- "exclude_archived_stories_percent_complete": true,
- "expenses_in_burn_rate": true,
- "external_reference_ids": [
- "string"
], - "financial_viewer_ids": [
- "string"
], - "has_active_expense_report_submissions": true,
- "has_active_timesheet_submissions": true,
- "has_budget_access": true,
- "lock_date": "2019-08-24",
- "minutes_logged": 0,
- "next_uncompleted_milestone_id": "string",
- "non_billable_minutes": 0,
- "over_budget": true,
- "participant_ids": [
- "string"
], - "participation_ids": [
- "string"
], - "percent_of_budget_used": 0,
- "percentage_complete": 0,
- "permissions": {
- "can_upload_files": true,
- "can_private_message": true,
- "can_join": true,
- "is_participant": true,
- "access_level": "string",
- "team_lead": true,
- "user_is_client": true,
- "can_change_price": true,
- "can_change_story_billable": true,
- "can_post": true,
- "can_edit": true,
- "restricted": true,
- "can_see_financials": true,
- "is_guest_on_project": true
}, - "possible_approver_ids": [
- "string"
], - "posts_require_privacy_decision": true,
- "price": "string",
- "price_in_cents": 0,
- "primary_counterpart_id": "string",
- "primary_maven_id": "string",
- "primary_workspace_group_id": "string",
- "provider_lead_name": "string",
- "rate_card_id": 0,
- "require_expense_approvals": true,
- "require_time_approvals": true,
- "stage": "string",
- "start_date": "2019-08-24",
- "status": {
- "color": "string",
- "key": "string",
- "message": "string"
}, - "status_report_ids": [
- "string"
], - "stories_are_fixed_fee_by_default": true,
- "target_margin": 0,
- "tasks_default_non_billable": true,
- "timesheet_submission_ids": [
- "string"
], - "title": "string",
- "total_expenses_in_cents": 0,
- "total_invoiced": "string",
- "total_minutes_approved": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "workspace_group_ids": [
- "string"
], - "workspace_invoice_preference_id": 0,
- "workspace_resource_ids": [
- "string"
], - "workspace_resources_with_unnamed_ids": [
- "string"
]
}, - "property2": {
- "access_level": "string",
- "account_color_id": "string",
- "account_features": {
- "time_trackable": true,
- "has_time_entry_role_picker": true,
- "project_side_panel": true
}, - "account_id": 0,
- "approver_id": "string",
- "approver_ids": [
- "string"
], - "archived": true,
- "billable_minutes": 0,
- "budget_remaining": "string",
- "budget_used": "string",
- "budget_used_in_cents": 0,
- "budgeted": true,
- "can_create_line_items": true,
- "can_invite": true,
- "change_orders_enabled": true,
- "client_lead_name": "string",
- "client_role_name": "string",
- "consultant_role_name": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "creator_id": "string",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "current_status_report_id": "string",
- "current_user_participation_id": "string",
- "custom_field_value_ids": [
- "string"
], - "default_rate": "string",
- "description": "string",
- "due_date": "2019-08-24",
- "effective_due_date": "2019-08-24",
- "estimated_minutes": 0,
- "exclude_archived_stories_percent_complete": true,
- "expenses_in_burn_rate": true,
- "external_reference_ids": [
- "string"
], - "financial_viewer_ids": [
- "string"
], - "has_active_expense_report_submissions": true,
- "has_active_timesheet_submissions": true,
- "has_budget_access": true,
- "lock_date": "2019-08-24",
- "minutes_logged": 0,
- "next_uncompleted_milestone_id": "string",
- "non_billable_minutes": 0,
- "over_budget": true,
- "participant_ids": [
- "string"
], - "participation_ids": [
- "string"
], - "percent_of_budget_used": 0,
- "percentage_complete": 0,
- "permissions": {
- "can_upload_files": true,
- "can_private_message": true,
- "can_join": true,
- "is_participant": true,
- "access_level": "string",
- "team_lead": true,
- "user_is_client": true,
- "can_change_price": true,
- "can_change_story_billable": true,
- "can_post": true,
- "can_edit": true,
- "restricted": true,
- "can_see_financials": true,
- "is_guest_on_project": true
}, - "possible_approver_ids": [
- "string"
], - "posts_require_privacy_decision": true,
- "price": "string",
- "price_in_cents": 0,
- "primary_counterpart_id": "string",
- "primary_maven_id": "string",
- "primary_workspace_group_id": "string",
- "provider_lead_name": "string",
- "rate_card_id": 0,
- "require_expense_approvals": true,
- "require_time_approvals": true,
- "stage": "string",
- "start_date": "2019-08-24",
- "status": {
- "color": "string",
- "key": "string",
- "message": "string"
}, - "status_report_ids": [
- "string"
], - "stories_are_fixed_fee_by_default": true,
- "target_margin": 0,
- "tasks_default_non_billable": true,
- "timesheet_submission_ids": [
- "string"
], - "title": "string",
- "total_expenses_in_cents": 0,
- "total_invoiced": "string",
- "total_minutes_approved": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "workspace_group_ids": [
- "string"
], - "workspace_invoice_preference_id": 0,
- "workspace_resource_ids": [
- "string"
], - "workspace_resources_with_unnamed_ids": [
- "string"
]
}
}, - "time_entries": {
- "property1": {
- "active_submission_id": "string",
- "approved": true,
- "billable": true,
- "cost_rate_in_cents": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "date_performed": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "invoice_id": "string",
- "is_invoiced": true,
- "location": "string",
- "notes": "string",
- "rate_in_cents": 0,
- "recent_submission_id": "string",
- "role_id": "string",
- "story_id": "string",
- "taxable": true,
- "time_in_minutes": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "user_can_edit": true,
- "user_id": "string",
- "workspace_id": "string"
}, - "property2": {
- "active_submission_id": "string",
- "approved": true,
- "billable": true,
- "cost_rate_in_cents": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "currency": "string",
- "currency_base_unit": 0,
- "currency_symbol": "string",
- "date_performed": "2019-08-24",
- "external_reference_ids": [
- "string"
], - "invoice_id": "string",
- "is_invoiced": true,
- "location": "string",
- "notes": "string",
- "rate_in_cents": 0,
- "recent_submission_id": "string",
- "role_id": "string",
- "story_id": "string",
- "taxable": true,
- "time_in_minutes": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "user_can_edit": true,
- "user_id": "string",
- "workspace_id": "string"
}
}
}
Approve a TimesheetSubmission. You must have Time Approval permissions.
This endpoint returns structured Resolution objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the resolutions
top-level JSON key.
Please see our Response Format section for more information.
{- "resolution": {
- "description": "string"
}
}
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "resolutions": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "description": "string",
- "target_id": 0,
- "target_type": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": 0
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "description": "string",
- "target_id": 0,
- "target_type": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": 0
}
}
}
You can cancel a TimesheetSubmission by accessing the cancel endpoint
This endpoint returns structured Resolution objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the resolutions
top-level JSON key.
Please see our Response Format section for more information.
{- "resolution": {
- "description": "string"
}
}
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "resolutions": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "description": "string",
- "target_id": 0,
- "target_type": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": 0
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "description": "string",
- "target_id": 0,
- "target_type": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": 0
}
}
}
You can reject a TimesheetSubmission by accessing the reject endpoint
This endpoint returns structured Resolution objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results
array
and will be indexed by ID in the resolutions
top-level JSON key.
Please see our Response Format section for more information.
{- "resolution": {
- "description": "string"
}
}
{- "count": 0,
- "meta": {
- "count": 0,
- "page_count": 0,
- "page_number": 0,
- "page_size": 0
}, - "results": [
- {
- "key": "string",
- "id": "string"
}
], - "resolutions": {
- "property1": {
- "created_at": "2019-08-24T14:15:22Z",
- "description": "string",
- "target_id": 0,
- "target_type": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": 0
}, - "property2": {
- "created_at": "2019-08-24T14:15:22Z",
- "description": "string",
- "target_id": 0,
- "target_type": "string",
- "type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "user_id": 0
}
}
}