Filter batch jobs | Respan Docs

curl -X POST https://api.respan.ai/api/v1/batches/list/ \
     -H "Authorization: Bearer eyJhbGciOi..." \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "count": 42,
  "results": [
    {
      "id": "batch_9f8d7c6a",
      "provider_id": "openai",
      "status": "completed",
      "request_count": 150,
      "completed_count": 148,
      "failed_count": 2,
      "total_cost": 3.5678,
      "is_usage_tracked": true,
      "is_active": false,
      "is_terminal": true,
      "created_at": "2024-04-10T12:00:00Z",
      "updated_at": "2024-04-10T14:30:00Z",
      "completed_at": "2024-04-10T14:30:00Z",
      "last_polled_at": "2024-04-10T14:35:00Z",
      "start_log_unique_id": "log_20240410_120000",
      "completion_log_unique_id": "log_20240410_143000",
      "provider_data": {}
    }
  ],
  "next": "https://api.respan.ai/api/v1/batches/list/?page=2",
  "previous": "https://api.respan.ai/api/v1/batches/list/?page=1"
}

Dashboard-authenticated POST-for-filtering route for batch jobs. Returns the same paginated response shape as GET /api/v1/batches/list/.

Query parameters

pageintegerOptional>=1

Page number.

page_sizeintegerOptional1-100

Number of results per page. Maximum 100.

Request

This endpoint expects an object.

statusstringOptional

Batch status filter.

provider_idstringOptional

Provider filter.

filtersmap from strings to anyOptional

Reserved for dashboard filter payloads.

Response

Paginated filtered list of batch jobs.

countinteger

Total number of matching batch jobs.

resultslist of objects

nextstring or null

URL for the next page, if any.

previousstring or null

URL for the previous page, if any.

Errors

400

Bad Request Error

401

Unauthorized Error

Headers

Query parameters

Request

Response

Errors