---
title: "Retrieve task usage metrics"
method: GET
path: "/projects/{project_id}:{branch}/tasks/{task_id}/usage-metrics"
tags: ["Tasks"]
---

# Retrieve task usage metrics

`GET /projects/{project_id}:{branch}/tasks/{task_id}/usage-metrics`

## Request

- Base URL: `https://api.lokalise.com/api2`
- URL: `https://api.lokalise.com/api2/projects/{project_id}:{branch}/tasks/{task_id}/usage-metrics`
- Auth: API key in header `X-Api-Token`

Retrieves usage metrics for a specific task. Data is available from November 3rd 2025 onwards.

Requires <code>read_tasks</code> OAuth access scope.

## Path parameters

- `project_id` string, required
- `branch` string, required
- `task_id` number, required

## Response `200`

OK

- object
  - `data` object
    - `processed_words` integer: The number of processed words consumed by the given task.

---

[API](https://skmtc.dev/lokalise/apis/projects-with-branches.md) - [All operations](https://skmtc.dev/lokalise/apis/projects-with-branches/llms.txt) - [OpenAPI document](https://skmtc.dev/lokalise/apis/projects-with-branches/revisions/7ed3f978a361?raw)