Skip to main content
GET
List background jobs

Authorizations

Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Get your API key from the Reply dashboard: Settings → API Key.

Query Parameters

top
integer

Maximum number of items to return (default 100, max 200)

skip
integer

Number of items to skip

category
string

Category suffix to filter by — prefix-matched against r2/bg-jobs/{suffix}. For example, pass email-validation to list only email-validation jobs. Omit to list all of the user's background jobs.

Response

Paginated list of background jobs

items
Background Job List Item · object[]
hasMore
boolean

Whether more items are available beyond the current page