## Retrieve Usage

**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.

### Returns

- `log_insights_usage: optional object { measurements, resource_uuid, start, stop }`

  Resource Usage Description

  - `measurements: optional array of object { tokens, usage_type }`

    - `tokens: optional number`

    - `usage_type: optional string`

  - `resource_uuid: optional string`

  - `start: optional string`

  - `stop: optional string`

- `usage: optional object { measurements, resource_uuid, start, stop }`

  Resource Usage Description

  - `measurements: optional array of object { tokens, usage_type }`

    - `tokens: optional number`

    - `usage_type: optional string`

  - `resource_uuid: optional string`

  - `start: optional string`

  - `stop: optional string`