Skip to content

Get AI Usage

GET
/api/v1/ai/usage

Get the authenticated user’s AI usage statistics for the current month, including requests used, limit, and remaining.

AI usage statistics

object
success
required
boolean
data
required
object
used
required

Number of AI requests used this month

integer
Example
12
limit
required

Monthly AI request limit for the current tier

integer
> 0
Example
50
remaining
required

AI requests remaining this month

integer
Example
38
resetDate
required

When the monthly counter resets

string format: date-time
Example
2024-01-15T10:30:00Z

Unauthorized

object
success
required

Always false for error responses

boolean
error
required

Error type

string
Example
Validation error
code

Machine-readable error code

string
Example
VALIDATION_ERROR
details

Detailed validation errors

Array<object>
object
path
required

Path to the invalid field

string
Example
currentAge
message
required

Error message

string
Example
Must be between 18 and 100