Skip to content
Authrim

List admin jobs.

GET
/api/admin/jobs
Code sample: Shell / cURL 
curl --request GET \
  --url 'https://auth.example.com/api/admin/jobs?limit=20&sort=created_at' \
  --header 'Authorization: Bearer <token>'

Lists tenant admin jobs with cursor-based pagination. The handler rejects page/page_size, validates limit, cursor, sort, and status/job_type filters, and returns data plus has_more and next_cursor metadata.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
limit
integer
default: 20 >= 1 <= 100
cursor
string
sort
string
Allowed values: created_at -created_at updated_at -updated_at status -status job_type -job_type
filter
string

Comma-separated filters for status and job_type, for example status:pending.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Cursor-paginated job list response.

Media type application/json
object
data
required
Array<object>
object
job_id
required
string
type
required
string
status
required
string
Allowed values: pending processing completed failed partial_failure
progress
required
object | null
created_by
required
string
created_at
required
string | null format: date-time
updated_at
required
string | null format: date-time
started_at
required
string | null format: date-time
completed_at
required
string | null format: date-time
estimated_completion
required
string | null format: date-time
next_run_at
required
string | null format: date-time
attempts
required
integer
max_attempts
required
integer
dead_lettered_at
required
string | null format: date-time
error_code
string
error_message
string
parameters
object
key
additional properties
key
additional properties
pagination
required
object
has_more
required
boolean
next_cursor
string
key
additional properties
key
additional properties
Example 
{
  "data": [
    {
      "job_id": "018f3f7c-85b0-7c5d-a6b6-1c3a6e6b9e01",
      "type": "users/import",
      "status": "pending",
      "progress": {
        "total": 0,
        "processed": 0,
        "succeeded": 0,
        "failed": 0,
        "stage": "queued"
      },
      "created_by": "admin_123",
      "created_at": "2026-02-01T00:00:00.000Z",
      "updated_at": "2026-02-01T00:00:00.000Z",
      "started_at": null,
      "completed_at": null,
      "estimated_completion": "2026-02-01T00:05:00.000Z",
      "next_run_at": null,
      "attempts": 0,
      "max_attempts": 3,
      "dead_lettered_at": null
    }
  ],
  "pagination": {
    "has_more": false
  }
}

400

Section titled “400 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Section titled “401 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Section titled “403 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

500

Section titled “500 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}