The Atlassian Marketplace REST API

Applications

Information about applications

Get applications

GET /rest/2/applications

Get a list of applications.

Request

Query parameters

offset

integer

If specified, skips ahead by this number of items

Format: int32

limit

integer

If specified, limits the result set to this number of items

Format: int32

Example

cURL

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://marketplace.atlassian.com/rest/2/applications' \
  --header 'Accept: application/json'

Responses

200

Content type	Value
application/json	ApplicationCollection

Get application

GET /rest/2/applications/{applicationKey}

Get a specific application.

Request

Path parameters

applicationKey Required

string

The unique identifier for this application, for example "jira"

Example

cURL

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://marketplace.atlassian.com/rest/2/applications/{applicationKey}' \
  --header 'Accept: application/json'

Responses

200

404

Content type	Value
application/json	Application

Get application versions

GET /rest/2/applications/{applicationKey}/versions

Get a list of versions for the specified application.

Request

Path parameters

applicationKey Required

string

The unique identifier for this application, for example "jira"

Query parameters

afterBuildNumber

integer

Selects only application versions whose build number is greater than this

Format: int64

offset

integer

If specified, skips ahead by this number of items

Format: int32

limit

integer

If specified, limits the result set to this number of items

Format: int32

Example

cURL

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://marketplace.atlassian.com/rest/2/applications/{applicationKey}/versions' \
  --header 'Accept: application/json'

Responses

200

404

Content type	Value
application/json	ApplicationVersionCollection

Get application version (by number)

GET /rest/2/applications/{applicationKey}/versions/build/{applicationBuildNumber}

Get details about a specific version, matching the specified build number, of the specified application.

Request

Path parameters

applicationKey Required

string

The unique identifier for this application, for example "jira"

applicationBuildNumber Required

integer

The unique integer identifier for the application version

Format: int64

Example

cURL

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://marketplace.atlassian.com/rest/2/applications/{applicationKey}/versions/build/{applicationBuildNumber}' \
  --header 'Accept: application/json'

Responses

200

404

Content type	Value
application/json	ApplicationVersion

Get application version (latest)

GET /rest/2/applications/{applicationKey}/versions/latest

Get the latest version of the specified application.

Request

Path parameters

applicationKey Required

string

The unique identifier for this application, for example "jira"

Example

cURL

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://marketplace.atlassian.com/rest/2/applications/{applicationKey}/versions/latest' \
  --header 'Accept: application/json'

Responses

200

404

Content type	Value
application/json	ApplicationVersion

Get application version (by name)

GET /rest/2/applications/{applicationKey}/versions/name/{name}

Get details about a specific version, matching the specified name, of the specified application.

Request

Path parameters

applicationKey Required

string

The unique identifier for this application, for example "jira"

name Required

string

The display name of the version, for example "1.0.0"

Example

cURL

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://marketplace.atlassian.com/rest/2/applications/{applicationKey}/versions/name/{name}' \
  --header 'Accept: application/json'

Responses

200

404

Content type	Value
application/json	ApplicationVersion