## Retrieve Usage

`agents.retrieve_usage(struuid, AgentRetrieveUsageParams**kwargs)  -> AgentRetrieveUsageResponse`

**get** `/v2/gen-ai/agents/{uuid}/usage`

To get agent usage, send a GET request to `/v2/gen-ai/agents/{uuid}/usage`. Returns usage metrics for the specified agent within the provided time range.

### Parameters

- `uuid: str`

- `start: Optional[str]`

  Return all usage data from this date.

- `stop: Optional[str]`

  Return all usage data up to this date, if omitted, will return up to the current date.

### Returns

- `class AgentRetrieveUsageResponse: …`

  Agent usage

  - `log_insights_usage: Optional[LogInsightsUsage]`

    Resource Usage Description

    - `measurements: Optional[List[LogInsightsUsageMeasurement]]`

      - `tokens: Optional[int]`

      - `usage_type: Optional[str]`

    - `resource_uuid: Optional[str]`

    - `start: Optional[datetime]`

    - `stop: Optional[datetime]`

  - `usage: Optional[Usage]`

    Resource Usage Description

    - `measurements: Optional[List[UsageMeasurement]]`

      - `tokens: Optional[int]`

      - `usage_type: Optional[str]`

    - `resource_uuid: Optional[str]`

    - `start: Optional[datetime]`

    - `stop: Optional[datetime]`

### Example

```python
from gradient import Gradient

client = Gradient()
response = client.agents.retrieve_usage(
    uuid="\"123e4567-e89b-12d3-a456-426614174000\"",
)
print(response.log_insights_usage)
```