TimecardQueryAction

Query the progress of timecards for specific projects. Supports partial matching of project names. If only one project matches, the system selects that project. If multiple projects match, it presents them for your selection; and if no projects match, the system returns an error.

Property	Value
Label	Query Timecards for Specified Projects.
Category	Time Management
Since	Winter 2026
Read-only	Yes
Supports Agents	Yes
Supports Flows	No
Async Action	No
Keywords	time tracking, missing timecards, incomplete timecards, timecard variance, awaiting approval

Request Parameters

Field	Type	Label	Description	Required
`endDate`	`Date`	End Date	The end date of timecard query.	No
`projectId`	`Id`	Project ID	The project ID used to query the timecards.	No
`projectName`	`String`	Project Name	The project name used to query the timecards.	No
`includeAwaitingApproval`	`Boolean`	Query Awaiting Approval Timecards by Project	A flag to indicate we want to query awaiting approval timecards, such as submitted timecards pending manager approval.	No
`includeIncomplete`	`Boolean`	Query Incomplete Timecards by Project	A flag to indicate we want to query incomplete timecards, such as unsubmitted or unapproved timecards.	No
`includeMissing`	`Boolean`	Query Missing Timecards by Project	A flag to indicate we want to query missing timecards for the specified project.	No
`includeSubmittedWithVariance`	`Boolean`	Query Submitted Timecards with Variance by Project	A flag to indicate we want to query submitted timecards that have a variance. For example, the timecard's total hours don't match the related schedule's total week hours.	No
`maxRecordsToReturn`	`Integer`	Maximum Number of Records to Return	Indicates the maximum number of records to return in the response.	No
`startDate`	`Date`	Start Date	The start date of timecard query.	No
`includeNotes`	`Boolean`	Include Notes	A flag that indicates whether notes should be displayed for the timecards.	No

Response Parameters

Field	Type	Label	Description	Required
`endDate`	`Date`	End Date	The end date of timecard query.	No
`errorStatusMessage`	`String`	Error Status Message	Error Status Message	No
`isError`	`Boolean`	Action Error Flag	Action Error Flag	No
`isResponseTruncated`	`Boolean`	Records Truncated Due to Limit	True if the number of records returned exceeds the maximum query limit. This indicates the result was truncated, and not all data is included.	No
`hasNotes`	`Boolean`	Has Notes	A flag that indicates whether the timecards contain notes.	No
`matchingProjects`	`List<Proj__c>`	Matching Projects	A list of projects that matches the partial project name.	No
`startDate`	`Date`	Start Date	The start date of timecard query.	No
`timecardResponses`	`List<TimecardActionTimecardResponse>`	Timecard Responses	A list of Timecard Response objects holding the timecard information and its status.	No
`missingTimecardRecords`	`List<TimecardActionMissingRecords>`	Missing Period for Timecards	Missing period on Assignment's timecard.	No
`timecardDataCounts`	`List<SmartActionRecordDataCount>`	Timecard Data Counts	A list of timecard data count objects that show the original and returned record counts for each timecard type.	No