v4

latestOpenAPI 3.0.1Apache 2.02026-08-016079122.3 MB
Issue worklogs

Get issue worklogs

Returns worklogs for an issue (ordered by created time), starting from the oldest worklog or from the worklog started on or after a date and time.

Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see Configuring time tracking.

This operation can be accessed anonymously.

Permissions required: Workloads are only returned where the user has:

  • Browse projects project permission for the project that the issue is in.
  • If issue-level security is configured, issue-level security permission to view the issue.
  • If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to.
get/rest/api/2/issue/{issueIdOrKey}/worklog

Path parameters

issueIdOrKeystring required

The ID or key of the issue.

Query parameters

startAtinteger

The index of the first item to return in a page of results (page offset).

maxResultsinteger

The maximum number of items to return per page.

startedAfterinteger

The worklog start date and time, as a UNIX timestamp in milliseconds, after which worklogs are returned.

startedBeforeinteger

The worklog start date and time, as a UNIX timestamp in milliseconds, before which worklogs are returned.

expandstring

Use expand to include additional information about worklogs in the response. This parameter acceptsproperties, which returns worklog properties.

Response

Returned if the request is successful

maxResultsinteger

The maximum number of results that could be on the page.

startAtinteger

The index of the first item returned on the page.

totalinteger

The number of results on the page.