{% note info %}
By default, the request returns only the last 10 log entries. To get more entries, use the [limit](#limit) parameter.
{% endnote %}
## Request format {#query}
Before sending a request, [get permission to access the API](https://yandex.ru/support/tracker/en/api-ref/access.md).
To get the logs, use an HTTP `GET` request:
```json translate=no
GET /v3/queues//triggers//webhooks/log
Host: api.tracker.yandex.net
Authorization: OAuth
X-Org-ID or X-Cloud-Org-ID:
```
{% cut "Headers" %}
* `Host`: address of the node that provides the API.
*
`Authorization`: Authorization token about these formats:
- `OAuth `: For authorization using the OAuth 2.0 protocol. [Learn more](https://yandex.ru/support/tracker/en/api-ref/access.md#about_OAuth)
- `Bearer `: For authorization using an IAM token, if a Yandex Identity Hub organization is linked to Tracker. [Learn more](https://yandex.ru/support/tracker/en/api-ref/access.md#iam-token)
*
`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 Identity Hub.
To get the organization ID, go to **Administration** → [**Organizations**](https://tracker.yandex.com/admin/orgs) and copy the value from the **ID** field. {#find-id}
{% endcut %}
{% cut "Resource" %}
| Parameter | Description | Data type |
-------- | -------- | ----------
| \ | Queue ID or key. The queue key is case-sensitive. | String or number. |
| \ | Trigger ID | String |
{% endcut %}
{% cut "Request parameters" %}
**Additional parameters**
| Parameter | Description | Data type |
----- | ----- | -----
| issueId | ID of the issue where the trigger was activated. | String |
| limit {#limit} | Number of log entries in the response. The default value is 10. The maximum value is 100. Example: `limit=100` | Number |
| from | Start of the log filter time range in `YYYY-MM-DDThh:mm:ss.sss±hhmm` format. | String |
| to | End of the log filter time range in `YYYY-MM-DDThh:mm:ss.sss±hhmm` format. | String |
{% endcut %}
> Example 1: Getting the last 100 log entries for a specific issue
> - An HTTP GET method is used.
> - A request is sent for a trigger from the `DEV` queue.
> - The trigger ID is 6.
> - The issue ID is `DEV-123`. The response will only contain logs linked to this issue.
> - Set the maximum number of log entries in the response.
> ```json translate=no
> GET /v3/queues/DEV/triggers/6/webhooks/log?issueId=DEV-123&limit=100
> Host: api.tracker.yandex.net
> Authorization: OAuth
> X-Org-ID or X-Cloud-Org-ID:
> ```
> Example 2: Getting log entries over a certain period
> - An HTTP GET method is used.
> - A request is sent for a trigger from the `DEV` queue.
> - The trigger ID is 6.
> - Set the time range: September 23, 2025, from 00:00 to 23:59.
> ```json translate=no
> GET /v3/queues/DEV/triggers/6/webhooks/log?from=2025-09-23T00:00:00&to=2025-09-23T23:59:59
> Host: api.tracker.yandex.net
> Authorization: OAuth
> X-Org-ID or X-Cloud-Org-ID:
> ```
## Response format {#answer}
{% list tabs %}
- Request executed successfully
If the request is successful, the API returns a response with code `200 OK`.
The response body contains the results in JSON format.
```json translate=no
[
{
"startTime": "2025-02-25T14:22:03.596+0000",
"endTime": "2025-02-25T14:22:03.831+0000",
"duration": 235,
"triggerId": 123***,
"actionId": 1,
"issueId": "66f682f13f442b**********",
"request": {
"method": "POST",
"endpoint": "https://api.telegram.org/bot123*******:AAHCATQsN**********/sendMessage",
"headers": {
"X-Startrek-Transport": "vNCc******/aRh5**********",
"Content-Type": "PSb4IkZm+OemrDmVvPX0h4uFOP8sKid9vp**********"
},
"body": "{\n\"chat_id\":\"-4116*****\",\n\"parse_mode\":\"markdown\",\n\"text\":\"Hello!\"\n}",
"webhookAuthContext": {
"type": "noauth"
}
},
"response": {
"headers": {
"Access-Control-Expose-Headers": "XXX",
"Strict-Transport-Security": "XXX",
"Server": "XXX",
"Access-Control-Allow-Origin": "XXX",
"Access-Control-Allow-Methods": "XXX",
"X-Ya-Instance": "XXX",
"Connection": "XXX",
"Content-Length": "XXX",
"Date": "XXX",
"Content-Type": "XXX"
},
"statusCode": 200
},
"id": "67bdd20b604a9c**********"
}
]
```
{% cut "Response parameters" %}
| Parameter | Description | Data type |
----- | ----- | -----
| startTime | Trigger activation start time in `YYYY-MM-DDThh:mm:ss.sss±hhmm` format. | String |
| endTime | Trigger activation end time in `YYYY-MM-DDThh:mm:ss.sss±hhmm` format. | String |
| duration | Trigger activation duration in milliseconds. | Number |
| triggerId | Trigger ID | Number |
| actionId | Trigger action ID. | Number |
| issueId | ID of the issue where the trigger was activated. | String |
| [request](#request) | Object with information about the parameters of the sent HTTP request. | Object |
| [response](#response) | Object with information about the parameters of the received response. | Object |
| id | Trigger activation ID. | String |
**request** `object fields` {#request}
| Parameter | Description | Data type |
----- | ----- | -----
| method | HTTP request method. | String |
| endpoint | URL of the resource where the HTTP request was sent to. | String |
| headers | HTTP request headers. | Object |
| body | HTTP request body. | String |
| [webhookAuthContext](#webhookAuthContext) | Object with information about the request authorization method. | Object |
`webhookAuthContext` **object fields** {#webhookAuthContext}
| Parameter | Description | Data type |
----- | ----- | -----
| type | Authorization method. | String |
**response** `object fields` {#response}
| Parameter | Description | Data type |
----- | ----- | -----
| headers | Response headers. | Object |
| statusCode | HTTP request status code. | Number |
{% endcut %}
- Request failed
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](https://yandex.ru/support/tracker/en/api-ref/access.md) 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.
{% endlist %}