Get changelogs by IDs

Returns changelogs for an issue specified by a list of changelog IDs.

This operation can be accessed anonymously.

Permissions required:

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.

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/issue//changelog/list' \ --header 'Content-Type: application/json' \ --data-raw '{ "changelogIds": [ 10001, 10002 ] }'

{"startAt":0,"maxResults":2,"total":2,"histories":[{"id":"10001","author":{"self":"https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g","accountId":"5b10a2844c20165700ede21g","emailAddress":"mia@example.com","avatarUrls":{"48x48":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48","24x24":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24","16x16":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16","32x32":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32"},"displayName":"Mia Krystof","active":true,"timeZone":"Australia/Sydney"},"created":"1970-01-18T06:27:50.429+0000","items":[{"field":"fields","fieldtype":"jira","fieldId":"fieldId","from":null,"fromString":"","to":null,"toString":"label-1"}]},{"id":"10002","author":{"self":"https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g","accountId":"5b10a2844c20165700ede21g","emailAddress":"mia@example.com","avatarUrls":{"48x48":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48","24x24":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24","16x16":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16","32x32":"https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32"},"displayName":"Mia Krystof","active":true,"timeZone":"Australia/Sydney"},"created":"1970-01-18T06:27:51.429+0000","items":[{"field":"fields","fieldtype":"jira","fieldId":"fieldId","from":null,"fromString":"label-1","to":null,"toString":"label-1 label-2"}]}]}

Responses

🟢200Returned if the request is successful.

application/json

Body

A page of changelogs.

histories

array[object (Changelog) {5}]

read-onlyoptional

The list of changelogs.

author

object

read-onlyoptional

The user who made the change.

created

string <date-time>

read-onlyoptional

The date on which the change took place.

historyMetadata

object

read-onlyoptional

The history metadata associated with the changed.

string

read-onlyoptional

The ID of the changelog.

items

array[object (ChangeDetails) {7}]

read-onlyoptional

The list of items changed.

maxResults

integer <int32>

read-onlyoptional

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

startAt

integer <int32>

read-onlyoptional

The index of the first item returned on the page.

total

integer <int32>

read-onlyoptional

The number of results on the page.

🟠400Returned if the request is not valid.

🟠404Returned if the issue is not found or the user does not have the necessary permission.

Get changelogs by IDs

Request

Responses