The Logs List endpoint allows you to get the past logs with specified filters.
You can add these params to the URL params. For example:
The field to sort by. Default is -id
(same as sort by -timestamp
, but with better performance).
-
is for descending order, if not provided, it will be in ascending order.
Properties
Sort by the ID of each request.
Sort by the cost of each request.
TTFT - useful for Voice AI applications
Generation time of each request.
Input / prompt tokens of each request.
Output / completion tokens of each request.
Total tokens of each request.
Example
Whether to include logs from all environments. is_test
parameter will override this parameter.
Options: true
, false
.
Whether the log is a test call or not. This parameter will override the all_envs
parameter.
Options: true
, false
.
Whether to retrieve the available filtering options. Enabling this could slow down the response time.
Options: true
, false
.
The number of logs to return per page. Maximum is 1000.
The page number of the current logs.
You can add these params to the body:
The filters be applied to the logs. For available options in the response body, use the fetch_filters
parameter.
metadata__
+ your custom property name. For example, if you want to filter your custom property my_custom_property
, you should add metadata__my_custom_property
to the filters.Example
Default is "" (equal).
Properties
Equal
Example
case insensitive equal
Less than
Less than or equal
Greater than
Greater than or equal
Can be used in arrays or text
Check if the field is null
Case insensitive contains