Finding out the number of issues

Use this request to find out the number of issues that meet the conditions of your request.

POST

https://api.tracker.yandex.net/v3/issues/_count

Query format

Before making a request, get permission to access the API.

To get the number of issues that meet certain criteria, use an HTTP POST request. The search criteria are passed in the request body in JSON format:

POST /v3/issues/_count
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID or X-Cloud-Org-ID: <organization_ID>

{
"filter": {
    "<field_name>": "<field_value>"
  },
  "query": "<query_language_filter>"
}
Headers

  • Host: Address of the node that provides the API.

  • Authorization: Authorization token about these formats:

    • OAuth <OAuth_token>: For authorization using the OAuth 2.0 protocol. Learn more

    • Bearer <IAM_token>: For authorization using an IAM token, if a Yandex Cloud Organization organization is linked to Tracker. Learn more

  • X-Org-ID or X-Cloud-Org-ID: Organization ID.

    • Use the X-Org-ID header if a Tracker organization is linked to Yandex 360 for Business.

    • Use the X-Cloud-Org-ID header if a Tracker organization is linked to Yandex Cloud Organization.

    To get the organization ID, go to Administration → Organizations and copy the value from the ID field.

Request body parameters

Additional parameters

Parameter Description Format
filter Issue filtering parameters. The parameter can specify any field and value to filter by. Map item
query Filter using the query language String

Request for the number of issues with additional filtering options:

  • An HTTP POST method is used.
  • The response should only contain the number of issues from the JUNE queue that do not have an assignee.
POST /v3/issues/_count HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID or X-Cloud-Org-ID: <organization_ID>

{
  "filter": {
    "queue": "JUNE",
    "assignee": "empty()"
  }
}

Response format

If the request is successful, the API returns a response with code 200 OK.

The response contains the number of issues that meet the conditions of your request.

5221186

If the request is processed incorrectly, the API returns a response with an error code:

400
One or more request parameters have an invalid value.
401
The user is not authorized. Make sure that actions described in the API access section are performed.
403
You are not authorized to perform this action. You can check what rights you have in the Tracker interface. The same rights are required to perform an action via the API and interface.
Previous
Moving an issue to another queue
Next
Finding issues