Skip to content
Ragex Docs

List API requests

GET
/v1/requests

View your recent API request history. Useful for monitoring, debugging, and understanding usage patterns. Returns requests sorted by most recent first.

By default, only API key requests are shown. Pass auth_type=jwt to see dashboard requests.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
method
string
Allowed values: GET POST PUT PATCH DELETE

Filter by HTTP method

status
string
Allowed values: 2xx 4xx 5xx

Filter by status group

status_code
integer
>= 100 <= 599

Filter by exact HTTP status code

path
string
<= 500 characters

Filter by request path (substring match)

kb_id
string

Filter by knowledge base ID

auth_type
string
default: api_key
Allowed values: api_key jwt

Filter by authentication type. Defaults to api_key.

since
string format: date-time

Only return requests after this ISO 8601 timestamp

until
string format: date-time

Only return requests before this ISO 8601 timestamp

cursor
string

Pagination cursor from a previous response’s meta.cursor field

limit
integer
>= 1

Maximum number of items to return per page

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Request log retrieved

object
data
required
Array<object>
object
id
required

Request ID (prefixed with req_)

string
Example
req_a1b2c3d4e5
method
required

HTTP method

string
Example
POST
path
required

Request path

string
Example
/api/v1/knowledge-bases/kb_x1y2z3/search
status_code
required

HTTP response status code

integer
Example
200
latency_ms
required

Request processing time in milliseconds

integer
Example
342
auth_type
required

Authentication method used

string
Allowed values: api_key jwt
Example
api_key
kb_id

Knowledge base ID if the request was scoped to a KB

string
nullable
Example
kb_x1y2z3w4v5
request_body

Summary of the request body (search query, top_k, etc.)

object
key
additional properties
any
created_at
required

When the request was made

string format: date-time
Example
2026-02-10T12:00:00.000Z
meta
required
object
cursor
required

Cursor to pass for the next page. Null if no more results.

string
nullable
Example
eyJpZCI6ImtiX2FiYzEyMyJ9
has_more
required

Whether more results are available

boolean
Example
true

401

Section titled “401 ”

Authentication failed or missing

object
error
required
object
code
required

Machine-readable error code

string
Allowed values: VALIDATION_ERROR AUTHENTICATION_ERROR NOT_FOUND CONFLICT RATE_LIMIT_EXCEEDED USAGE_LIMIT_EXCEEDED EXTERNAL_SERVICE_ERROR INTERNAL_ERROR
Example
VALIDATION_ERROR
message
required

Human-readable error message

string
Example
Invalid request body
details

Additional error details (e.g., validation issues)

object
key
additional properties
any
Example
{
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Invalid or missing API key"
  }
}

429

Section titled “429 ”

Rate limit exceeded

object
error
required
object
code
required

Machine-readable error code

string
Allowed values: VALIDATION_ERROR AUTHENTICATION_ERROR NOT_FOUND CONFLICT RATE_LIMIT_EXCEEDED USAGE_LIMIT_EXCEEDED EXTERNAL_SERVICE_ERROR INTERNAL_ERROR
Example
VALIDATION_ERROR
message
required

Human-readable error message

string
Example
Invalid request body
details

Additional error details (e.g., validation issues)

object
key
additional properties
any
Example
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded"
  }
}