retrieve and export raw data about commits, lines of code, and pull requests. |
The Awesome Graphs' REST API gives you the capability to export raw data about commits, lines of code, and pull requests. Using it, you can:
The Awesome Graphs REST API is available beginning with version 5.2.0 of the app. You can access the REST API reference documentation at the People page by clicking on Export → REST API or via the link: <bitbucket-host>/plugins/servlet/graphs-api. If it's not available to you, then you'll need to update the app.
The REST API provides access to resources via URI paths, uses JSON as its communication format, and the standard HTTP methods like GET, PUT, POST and DELETE.
The URIs for resources have the following structure:
https://%bitbucket-host%/rest/awesome-graphs-api/latest/%resource-name% |
For example:
https://%bitbucket-host%/rest/awesome-graphs-api/latest/commits |
Here is the curl command to retrieve the number of commits and lines of code added and deleted in all projects and repositories for the specified period:
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/commits/statistics?sinceDate=2020-01-01&untilDate=2020-02-01" |
Below is an example of the response:
{ "linesOfCode":{ "added":64590, "deleted":34630 }, "commits":1230 } |
Question mark ( ? ) introduces the query string parameters. The parameters are separated with an ampersand ( & ) separating them. The order of the parameters does not matter. |
Awesome Graphs' REST API uses pagination to improve performance and limit response size of operations that could return a large collection of items.
Below is the list of resources to retrieve and export commit data.
Returns aggregated data from all projects and repositories. Will only return the information from the projects and repositories that the authenticated user has PROJECT_READ and REPO_READ permissions for.
GET /rest/awesome-graphs-api/latest/commits
Returns a list of commits from all Bitbucket projects and repositories.
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits, or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
start | integer | Indicates which item should be used as the first item on the page of results. Defaults to 0. |
limit | integer | Indicates how many results to return per page. Defaults to 25. Max value is 1000. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/commits" |
|
GET /rest/awesome-graphs-api/latest/commits/statistics
Returns the number of commits and lines of code added/deleted in all projects and repositories.
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits, or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/commits/statistics" |
|
GET /rest/awesome-graphs-api/latest/commits/export/csv
Exports the list of commits with their details from all Bitbucket projects and repositories to a CSV file.
By default, exports the data for the last 30 days. You can set a timeframe for exported data up to one year (366 days) with sinceDate / untilDate parameters.
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/commits/export/csv" |
|
Returns information about the specified project. The authenticated user must have PROJECT_READ permission for the stated projects to call these resources.
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/commits
Returns a list of commits from all repositories in the specified project.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits, or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
start | integer | Indicates which item should be used as the first item on the page of results. Defaults to 0. |
limit | integer | Indicates how many results to return per page. Defaults to 25. Max value is 1000. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/commits" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/commits/statistics
Returns the number of commits and lines of code added/deleted in the specified project.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits, or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/commits/statistics" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/commits/export/csv
Exports the list of commits with their details from all repositories in the specified project to a CSV file.
By default, exports the data for the last 30 days. You can set a timeframe for exported data up to one year (366 days) with sinceDate / untilDate parameters.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/commits/export/csv" |
|
Returns information about a particular user. Will only return the information from the repositories that the authenticated user has REPO_READ permissions for.
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/commits
Returns a list of commits from the specified repository.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
repositorySlug | string | The slug of a particular repository to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits, or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
start | integer | Indicates which item should be used as the first item on the page of results. Defaults to 0. |
limit | integer | Indicates how many results to return per page. Defaults to 25. Max value is 1000. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/commits" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/commits/statistics
Returns the number of commits and lines of code added/deleted in the specified repository.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
repositorySlug | string | The slug of a particular repository to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits, or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/commits/statistics" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/commits/export/csv
Exports the list of commits with their details from the specified repository to a CSV file.
By default, exports the data for the last 30 days. You can set a timeframe for exported data up to one year (366 days) with sinceDate / untilDate parameters.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
repositorySlug | string | The slug of a particular repository to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/commits/export/csv" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}
Returns the data of the specified commit identified by its ID.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
repositorySlug | string | The slug of a particular repository to retrieve data from. |
commitId | string | The hash of a particular commit to get the data of. |
Query Parameters
Parameter | Value | Description |
---|---|---|
withFiles | boolean | If present, returns a list of files changed in a particular commit with the number of lines added and deleted in each file. The default value is false. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}" |
|
Returns information about a particular user. Will only return the information from the repositories that the authenticated user has REPO_READ permissions for.
GET /rest/awesome-graphs-api/latest/users/{userSlug}/commits
Returns a list of commits of a particular user, including commits made by the user's aliases.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
userSlug | string | URL-friendly version of a username (e.g. 'boomer' instead of 'bøømer', 'boo-mer' instead of 'boo mer'). |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits, or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
start | integer | Indicates which item should be used as the first item on the page of results. Defaults to 0. |
limit | integer | Indicates how many results to return per page. Defaults to 25. Max value is 1000. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/users/{userSlug}/commits" |
|
GET /rest/awesome-graphs-api/latest/users/{userSlug}/commits/statistics
Returns the number of commits and lines of code added/deleted by a particular user.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
userSlug | string | URL-friendly version of a username (e.g. 'boomer' instead of 'bøømer', 'boo-mer' instead of 'boo mer'). |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits, or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/users/{userSlug}/commits/statistics" |
|
GET /rest/awesome-graphs-api/latest/users/{userSlug}/commits/export/csv
Exports the list of commits with their details made by a particular user to a CSV file, including commits made by the user's aliases.
By default, exports the data for the last 30 days. You can set a timeframe for exported data up to one year (366 days) with sinceDate / untilDate parameters.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
userSlug | string | URL-friendly version of a username (e.g. 'boomer' instead of 'bøømer', 'boo-mer' instead of 'boo mer'). |
Query Parameters
Parameter | Value | Description |
---|---|---|
merges | string | If present, controls how merge commits should be filtered. Can be either exclude, to exclude merge commits, include, to include both merge commits and non-merge commits or only, to only return merge commits. Defaults to include. |
sinceDate | string | Date in ISO-8601 format to retrieve commits since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve commits until. Example: 1997-07-16T19:20:30+01:00. |
order | string | The order to return commits in, either oldest (as in: "oldest first") or newest. Defaults to newest. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/users/{userSlug}/commits/export/csv" |
|
Below is the list of resources to retrieve and export pull request data.
Returns aggregated data from all projects and repositories. Will only return the information from the projects and repositories that the authenticated user has PROJECT_READ and REPO_READ permissions for.
GET /rest/awesome-graphs-api/latest/pull-requests
Returns a list of pull requests from all Bitbucket projects and repositories.
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
start | integer | Indicates which item should be used as the first item on the page of results. Defaults to 0. |
limit | integer | Indicates how many results to return per page. Defaults to 25. Max value is 500. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/pull-requests" |
|
GET /rest/awesome-graphs-api/latest/pull-requests/statistics
Returns the number of pull requests in all projects and repositories.
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/pull-requests/statistics" |
|
GET /rest/awesome-graphs-api/latest/pull-requests/export/csv
Exports the list of pull requests with their details from all Bitbucket projects and repositories to a CSV file.
By default, exports the data for the last 30 days. You can set a timeframe for exported data up to one year (366 days) with sinceDate / untilDate parameters.
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/pull-requests/export/csv" |
|
Returns information about the specified project. The authenticated user must have PROJECT_READ permission for the stated projects to call these resources.
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/pull-requests
Returns a list of pull requests from all repositories in the specified project.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
start | integer | Indicates which item should be used as the first item on the page of results. Defaults to 0. |
limit | integer | Indicates how many results to return per page. Defaults to 25. Max value is 500. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/pull-requests" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/pull-requests/statistics
Returns the number of pull requests in the specified project.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/pull-requests/statistics" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/pull-requests/export/csv
Exports the list of pull requests with their details from all repositories in the specified project to a CSV file.
By default, exports the data for the last 30 days. You can set a timeframe for exported data up to one year (366 days) with sinceDate / untilDate parameters.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/pull-requests/export/csv" |
|
Returns information about the specified repository. The authenticated user must have REPO_READ permission for the stated repositories to call these resources.
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/pull-requests
Returns a list of pull requests from the specified repository.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
repositorySlug | string | The slug of a particular repository to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
start | integer | Indicates which item should be used as the first item on the page of results. Defaults to 0. |
limit | integer | Indicates how many results to return per page. Defaults to 25. Max value is 500. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/pull-requests" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/pull-requests/statistics
Returns the number of pull requests in the specified repository.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
repositorySlug | string | The slug of a particular repository to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/pull-requests/statistics" |
|
GET /rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/pull-requests/export/csv
Exports the list of pull requests with their details from the specified repository to a CSV file.
By default, exports the data for the last 30 days. You can set a timeframe for exported data up to one year (366 days) with sinceDate / untilDate parameters.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
projectKey | string | The key of a particular project to retrieve data from. |
repositorySlug | string | The slug of a particular repository to retrieve data from. |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/projects/{projectKey}/repos/{repositorySlug}/pull-requests/export/csv" |
|
Returns information about a particular user. Will only return the information from the repositories that the authenticated user has REPO_READ permissions for.
GET /rest/awesome-graphs-api/latest/users/{userSlug}/pull-requests
Returns a list of pull requests created by a particular user.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
userSlug | string | URL-friendly version of a username (e.g. 'boomer' instead of 'bøømer', 'boo-mer' instead of 'boo mer'). |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
start | integer | Indicates which item should be used as the first item on the page of results. Defaults to 0. |
limit | integer | Indicates how many results to return per page. Defaults to 25. Max value is 500. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/users/{userSlug}/pull-requests" |
|
GET /rest/awesome-graphs-api/latest/users/{userSlug}/pull-requests/statistics
Returns the number of pull requests created by a particular user.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
userSlug | string | URL-friendly version of a username (e.g. 'boomer' instead of 'bøømer', 'boo-mer' instead of 'boo mer'). |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/users/{userSlug}/pull-requests/statistics" |
|
GET /rest/awesome-graphs-api/latest/users/{userSlug}/pull-requests/export/csv
Exports the list of pull requests with their details created by a particular user to a CSV file.
By default, exports the data for the last 30 days. You can set a timeframe for exported data up to one year (366 days) with sinceDate / untilDate parameters.
Path Parameters (required)
Parameter | Value | Description |
---|---|---|
userSlug | string | URL-friendly version of a username (e.g. 'boomer' instead of 'bøømer', 'boo-mer' instead of 'boo mer'). |
Query Parameters
Parameter | Value | Description |
---|---|---|
state | string | If indicated, only pull requests in the specified state will be returned. Can be either all, open, merged, declined. Defaults to all. |
dateType | string | Defines what date type is used for sinceDate / untilDate filtering. Can be either created or updated. Defaults to created. |
sinceDate | string | Date in ISO-8601 format to retrieve pull requests since. Example: 1997-07-16T19:20:30+01:00. |
untilDate | string | Date in ISO-8601 format to retrieve pull requests until. Example: 1997-07-16T19:20:30+01:00. |
Request Example
curl -X GET -u username:password "https://%bitbucket-host%/rest/awesome-graphs-api/latest/users/{userSlug}/pull-requests/export/csv" |
|