Skip to main content
GET
Get a comprehensive list of all requests you’ve created using your API key. This endpoint provides detailed information about each request including current status, response data, and performance metrics.

Authentication

Authorization
string
required
Your API key for authentication

Query Parameters

status
string
Filter requests by status
Options: pending, completed, timeout, cancelled
priority
string
Filter requests by priority level
Options: low, medium, high, critical
loop_id
string
Filter requests from a specific loop
limit
integer
Maximum number of requests to return (1-100, default: 50)
offset
integer
Number of requests to skip for pagination (default: 0)
sort
string
Sort order for results
Options: created_at_desc (default), created_at_asc, priority_desc, status_asc

Response

error
boolean
Whether an error occurred
msg
string
Success message
data
object

Request Status Overview

Pending

Status: pending
  • Waiting for reviewer response
  • No response yet
  • Can be cancelled

Completed

Status: completed
  • Reviewer submitted response
  • response_data contains the answer
  • Can receive feedback

Timeout

Status: timeout
  • Request exceeded timeout period
  • default_response used as final answer
  • No further action possible

Cancelled

Status: cancelled
  • Request was cancelled before completion
  • No response data available
  • Final status

Filtering and Sorting

Advanced Filtering Examples

Pagination Best Practices

Efficient Pagination

Handle large datasets efficiently:

Cursor-based Pagination (Alternative)

For very large datasets, implement cursor-based pagination:

Request Performance Analysis

Response Time Analysis

Analyze reviewer performance:

Priority Distribution

Track request priority patterns:

Export and Reporting

CSV Export

Export request data for analysis:

Error Handling

Next Steps

Get Specific Request

Retrieve detailed information about a specific request including response data.

Create New Request

Create a new human review request within a loop.