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