Skip to content
API Reference/
/
analytics_conversations_r...

ibl-data-manager (4.84.1-ai-plus)

API for iblai

Download OpenAPI description
ibl.json
ibl.yaml
Languages
Servers
Mock server
https://docs.ibl.ai/_mock/apis/ibl/
https://base.manager.iblai.app/

ai-account

Operations

ai-analytics

Operations

Get Content Details

Request

Retrieve detailed analytics for a specific content item including summary statistics, learner-level data, and optional time series information.

Security
PlatformApiKeyAuthentication
Path
content_idstringrequired
Query
date_filterstringnon-empty
  • today - Today only
  • 7d - Last 7 days
  • 30d - Last 30 days
  • 90d - Last 90 days
  • all_time - All time
  • custom - Custom date range
Default "today"
Enum"today""7d""30d""90d""all_time""custom"
end_datestring(date)
limitinteger[ 1 .. 30 ]

Number of learner records per page

Default 10
mentor_unique_idstring(uuid)
metricstringnon-emptyrequired

Content type to fetch (course, program, pathway, skill)

  • course - course
  • courses - courses
  • program - program
  • programs - programs
  • pathway - pathway
  • pathways - pathways
  • skill - skill
  • skills - skills
Enum"course""courses""program""programs""pathway""pathways""skill""skills"
pageinteger>= 1
Default 1
platform_keystringnon-empty
searchstring
start_datestring(date)
time_metricstring or null

Optional time series metric (enrollments, completions, ratings, time_spent)

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/analytics/content/details/{content_id}/?date_filter=today&end_date=2019-08-24&limit=10&mentor_unique_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&metric=course&page=1&platform_key=string&search=string&start_date=2019-08-24&time_metric=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
content_infoobject(ContentDetailsContentInfo)required

Serializer for the content information block.

content_info.​idstringrequired

Identifier for the content item

content_info.​namestring or null
content_info.​typestringrequired

Content type (course, program, pathway, skill)

content_info.​slugstring or null
content_info.​platformstring or null
content_info.​externalbooleanrequired

Whether the content is external to the platform

content_info.​metadataobject

Metadata associated with the content item

summaryobject(ContentDetailsSummary)required

Serializer for summary data in the content details endpoint.

summary.​totalsobjectrequired

Total counts related to the content item

summary.​totals.​property name*number(double)additional property
summary.​averagesobjectrequired

Average values related to the content item

summary.​averages.​property name*number or null(double)additional property
summary.​time_seriesobject
paginationobject(ContentDetailsPagination)required

Serializer for pagination information in content details response.

pagination.​countintegerrequired

Total learner records

pagination.​nextstring or null

Relative URL for the next page

pagination.​previousstring or null

Relative URL for the previous page

pagination.​current_pageintegerrequired

Current page number

pagination.​total_pagesintegerrequired

Total number of pages

learnersArray of objects(ContentDetailsLearner)required
learners[].​user_idintegerrequired

Learner identifier

learners[].​usernamestring or nullrequired

Learner username

learners[].​emailstring or null(email)required

Learner email

learners[].​namestring or nullrequired

Learner display name

learners[].​enrollment_datestring or null(date-time)required

Date the learner enrolled in the content

learners[].​completion_statusstringrequired

Completion status for the learner

learners[].​completion_percentagenumber or null(double)required

Learner completion percentage

learners[].​last_activitystring or null(date-time)required

Last activity timestamp for the learner

learners[].​ratingnumber or null(double)required

Learner rating for the content, if available

learners[].​reviewstring or nullrequired

Learner review content, if available

learners[].​detailsobject

Additional learner-specific metadata

Response
application/json
{
  "content_info": {
    "id": "string",
    "name": "string",
    "type": "string",
    "slug": "string",
    "platform": "string",
    "external": true,
    "metadata": { … }
  },
  "summary": {
    "totals": { … },
    "averages": { … },
    "time_series": { … }
  },
  "pagination": {
    "count": 0,
    "next": "string",
    "previous": "string",
    "current_page": 0,
    "total_pages": 0
  },
  "learners": [
    { … }
  ]
}

analytics_conversations_retrieve

Request

Security
PlatformApiKeyAuthentication
Query
date_filterstringnon-empty
  • today - Today only
  • 7d - Last 7 days
  • 30d - Last 30 days
  • 90d - Last 90 days
  • all_time - All time
  • custom - Custom date range
Default "today"
Enum"today""7d""30d""90d""all_time""custom"
end_datestring(date)
granularitystringnon-empty
  • day - day
  • hour - hour
  • week - week
  • month - month
Default "hour"
Enum"day""hour""week""month"
mentor_unique_idstring(uuid)
metricstringnon-empty
  • conversations - Conversations over time
  • headline - Headline metrics for conversations (avg messages per conversation, avg rating)
Default "conversations"
Enum"conversations""headline"
platform_keystringnon-empty
start_datestring(date)
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/analytics/conversations/?date_filter=today&end_date=2019-08-24&granularity=day&mentor_unique_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&metric=conversations&platform_key=string&start_date=2019-08-24' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
metricstringrequired
pointsArray of objects(ConversationChartPoint)required
points[].​datestring(date-time)required
points[].​valueintegerrequired
Response
application/json
{
  "metric": "string",
  "points": [
    { … }
  ]
}

analytics_financial_retrieve

Request

Financial Analytics API - Get comprehensive cost metrics with comparison analysis.

This endpoint provides period-based cost analysis (not cumulative) with support for:

  • Multiple time granularities and metrics
  • Cross-dimensional filtering
  • Percentage change vs comparison periods
  • Forward-filled time series

Examples:

Basic Weekly Costs:

GET /api/analytics/financial/?metric=weekly_costs&comparison_days=10

Platform & Mentor Filtered:

# Get total costs for a specific platform and mentor
GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14

Monthly Costs by Provider:

GET /api/analytics/financial/?metric=monthly_costs&provider=openai&granularity=month&comparison_days=30

Daily Costs for Specific User:

GET /api/analytics/financial/?metric=total_costs&username=user-456&granularity=day&start_date=2025-01-15&end_date=2025-01-21&comparison_days=7

Response Structure:

{
    "metric": "weekly_costs",
    "value": 12.47,
    "percentage_change": 8.5,
    "overtime": [
        {"date": "2025-01-06", "value": 2.89},
        {"date": "2025-01-13", "value": 3.12}
    ],
    "period_info": {
        "start_date": "2025-01-01",
        "end_date": "2025-01-31",
        "period_days": 31
    },
    "comparison_info": {
        "previous_period_value": 11.50,
        ...
    }
}
Security
PlatformApiKeyAuthentication
Query
comparison_daysinteger>= 1

Number of days for comparison period to calculate percentage change (e.g., 10 for 10-day comparison)

date_filterstringnon-empty
  • today - Today only
  • 7d - Last 7 days
  • 30d - Last 30 days
  • 90d - Last 90 days
  • all_time - All time
  • custom - Custom date range
Default "today"
Enum"today""7d""30d""90d""all_time""custom"
end_datestring(date)
fill_methodstringnon-empty

Method for filling missing time periods in overtime data

  • zero - Fill missing periods with zero
  • previous - Fill missing periods with previous value
Default "zero"
Enum"zero""previous"
granularitystringnon-empty

Time granularity for overtime series data

  • day - Daily data points
  • week - Weekly data points
  • month - Monthly data points
Default "day"
Enum"day""week""month"
llm_modelstringnon-empty

Filter by specific LLM model (e.g., gpt-4o, claude-3-5-sonnet)

mentor_unique_idstring(uuid)
metricstringnon-emptyrequired

Type of financial metric to retrieve

  • total_costs - Total costs for selected timeframe
  • weekly_costs - Costs for current/selected week
  • monthly_costs - Costs for current/selected month
Enum"total_costs""weekly_costs""monthly_costs"
platform_keystringnon-empty
providerstringnon-empty

Filter by AI provider

  • openai - OpenAI
  • anthropic - Anthropic
  • azure - Azure
  • google - Google
  • meta - Meta
  • other - Other
Enum"openai""anthropic""azure""google""meta""other"
show_overtimeboolean

Whether to include overtime series data in response

Default true
start_datestring(date)
usernamestringnon-empty

Filter by specific username - returns costs for this user only

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/analytics/financial/?comparison_days=1&date_filter=today&end_date=2019-08-24&fill_method=zero&granularity=day&llm_model=string&mentor_unique_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&metric=total_costs&platform_key=string&provider=openai&show_overtime=true&start_date=2019-08-24&username=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successful financial metrics response with period-based cost data

Bodyapplication/json
metricstringrequired

The metric type that was requested

filtersobjectrequired
filters.​start_datestring
filters.​end_datestring
filters.​granularitystringrequired
filters.​comparison_daysinteger
filters.​platform_keystring
filters.​mentor_unique_idstring
filters.​usernamestring
filters.​providerstring
filters.​llm_modelstring
filters.​all_timeboolean
valuestring(decimal)^-?\d{0,15}(?:\.\d{0,5})?$required

Primary metric value (cost in USD)

percentage_changenumber or null(double)required

Percentage change vs comparison period (null if no comparison)

overtimeArray of objects(OvertimeData)required

Time series data for overtime visualization

overtime[].​datestringrequired

Date in YYYY-MM-DD format

overtime[].​valuestring(decimal)^-?\d{0,15}(?:\.\d{0,5})?$required

Cost value for this time period

period_infoobjectrequired
period_info.​start_datestring

Start date of analysis period

period_info.​end_datestring

End date of analysis period

period_info.​period_daysinteger

Number of days in period

period_info.​range_typestring

Type of date range (custom, default, all_time, etc.)

comparison_infoobjectrequired
comparison_info.​previous_period_countinteger

Number of days in comparison period

comparison_info.​previous_period_valuestring(decimal)^-?\d{0,15}(?:\.\d{0,5})?$

Cost value for comparison period

comparison_info.​comparison_startstring

Start date of comparison period

comparison_info.​comparison_endstring

End date of comparison period

comparison_info.​comparison_daysinteger

Number of comparison days

comparison_info.​recent_period_valuestring(decimal)^-?\d{0,15}(?:\.\d{0,5})?$

Cost value for current period

Response
application/json

Response for total_costs metric.

{
  "metric": "total_costs",
  "filters": {
    "start_date": "2025-01-01",
    "end_date": "2025-01-31",
    "granularity": "day",
    "comparison_days": 10
  },
  "value": 45.789,
  "percentage_change": 15.2,
  "overtime": [
    { … },
    { … },
    { … },
    { … },
    { … }
  ],
  "period_info": {
    "start_date": "2025-01-01",
    "end_date": "2025-01-31",
    "period_days": 31,
    "range_type": "custom"
  },
  "comparison_info": {
    "previous_period_count": 10,
    "previous_period_value": 39.654,
    "comparison_start": "2024-12-22",
    "comparison_end": "2024-12-31",
    "comparison_days": 10,
    "recent_period_value": 45.789
  }
}

ai-bot

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai-prompt

Operations

analytics

Operations

career

Operations

catalog

Operations

core

Operations

credentials

Operations

custom-domains

Operations

features

Operations

media

Operations

notifications

Operations

scim

Operations

commerce

Operations

recommendations

Operations

reports

Operations

skills

Operations
Copyright © ibl.ai | support@iblai.zendesk.com