Get Graph Usage

get/v1/graphs/{graph_id}/usage

Part of Usage.

Time ranges: 24h, 7d, 30d, current_month, last_month. Toggle storage, credits, performance, and events sections via query params.

Authentication

Authenticate in any one of these ways — not all of them:

Name	Type	Description
`graph_id`required	string	Graph Id

Name	Type	Description
`time_range`optional	string	Time range: 24h, 7d, 30d, current_month, last_month Default: `"30d"`
`include_storage`optional	boolean	Include storage usage summary Default: `true`
`include_credits`optional	boolean	Include credit consumption summary Default: `true`
`include_performance`optional	boolean	Include performance insights (may be slower) Default: `false`
`include_events`optional	boolean	Include recent usage events Default: `false`

curl

curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/usage" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

200 Successful Response

Field Type Description

graph_idrequired

string

Graph database identifier

time_rangerequired

string

Time range for usage data

storage_summaryoptional

StorageSummary

Storage usage summary

StorageSummary fields

Field	Type	Description
`graph_tier`required	string	Subscription tier
`avg_storage_gb`required	number	Time-weighted average storage in GB over the period
`max_storage_gb`required	number	Peak storage in GB
`min_storage_gb`required	number	Minimum storage in GB
`measurement_count`required	integer	Number of measurements taken

credit_summaryoptional

CreditSummary

Credit consumption summary

CreditSummary fields

Field	Type	Description
`graph_tier`required	string	Subscription tier
`total_credits_consumed`required	number	Total credits consumed
`total_base_cost`required	number	Total base cost before multipliers
`operation_breakdown`required	object	Credit usage by operation type
`cached_operations`required	integer	Number of cached operations
`billable_operations`required	integer	Number of billable operations
`transaction_count`required	integer	Total transaction count

performance_insightsoptional

PerformanceInsights

Performance analytics

PerformanceInsights fields

Field	Type	Description
`analysis_period_days`required	integer	Analysis period in days
`total_operations`required	integer	Total operations analyzed
`operation_stats`required	object	Performance stats by operation type
`slow_queries`required	object[]	Top slow queries (over 5 seconds)
`performance_score`required	integer	Performance score (0-100)

recent_eventsoptional

object[]

Recent usage events

timestamprequired

string

Usage collection timestamp