# ai_analytics_orgs_users_costs_permentor_retrieve

Retrieve LLM usage costs aggregated by mentor.

This endpoint returns data on the total cost of LLM usage for each mentor
within a specified date range, with pagination support. The costs are
calculated by summing the costs of all observations associated with
traces from the mentor's sessions.

Args:
    request: The HTTP request containing filter query parameters.
    org: Organization key identifier.

Returns:
    Response: Paginated list of mentors with their total LLM usage costs.

Raises:
    NotFound: If the specified organization does not exist.
    BadRequest: If the provided parameters are invalid.

Query Parameters:
    start_date (str): Start date for filtering (YYYY-MM-DD) - required.
    end_date (str): End date for filtering (YYYY-MM-DD) - required.
    limit (int): Number of results per page - default: 5.
    offset (int): Offset for pagination - default: 0.

Endpoint: GET /api/ai-analytics/orgs/{org}/users/{user_id}/costs/permentor/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `end_date` (string, required)

  - `start_date` (string, required)

## Path parameters:

  - `org` (string, required)

  - `user_id` (string, required)

## Response 200 fields (application/json):

  - `tenant` (string, required)

  - `tenant_total_cost` (number, required)

  - `mentor_data` (array, required)

  - `mentor_data.mentor_unique_id` (string, required)

  - `mentor_data.mentor_name` (string, required)

  - `mentor_data.total_cost` (number, required)

  - `mentor_data.mentor_sessions` (array, required)

  - `mentor_data.mentor_sessions.session_id` (string, required)

  - `mentor_data.mentor_sessions.cost` (number, required)