Get the status and progress of ongoing jobs

Check the status of a specific job, such as a domain operation. Returns detailed information about the job's current status, progress, completion, or failure, and relevant IDs if the job results in an invoice or order.

Domain Services Domains

Context

Workflow links

Produces

Path Parameters

jobId string required Example: bulk_renew-1000-1700000000000

jobId parameter

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.createdAt string required · Example: 2026-02-10T00:00:00.000Z
data.delay string · nullable required · Example: null

Nullable: may be null when not applicable.

data.finishedAt string · nullable required · Example: 2026-02-10T00:00:00.000Z

Nullable: may be null when not applicable.

data.hostbillAccountId string · nullable required · Example: null

Nullable: may be null when not applicable.

data.isCompleted boolean required · Example: true
data.isFailed boolean required · Example: false
data.isRunning boolean required · Example: false
data.isScheduled boolean required · Example: false
data.isWaiting boolean required · Example: false
data.jobId string required · Example: bulk_renew-1000-1700000000000
data.jobName string required · Example: bulk_renew-6832
data.progress integer required · Example: 100
data.progressDetails object required
data.progressDetails.current integer required · Example: 14
data.progressDetails.message string required · Example: Operation completed

Human-readable message.

data.progressDetails.percentage integer required · Example: 100
data.progressDetails.total integer required · Example: 14
data.progressMessage string required · Example: Operation completed
data.progressTextKey string required · Example: instance.jobs.completed_successfully
data.queueType string required · Example: domain
data.result object · nullable required

Nullable: may be null when not applicable.

data.result.clientId string required · Example: 30000
data.result.result object required
data.result.result.clientId string required · Example: 30000
data.result.result.domains_renewed integer required · Example: 14
data.result.result.domains_skipped integer required · Example: 0
data.result.result.invoice_id string required · Example: 51890
data.result.result.order_id integer required · Example: 35620
data.result.result.order_number string required · Example: 313533390
data.result.result.proforma_id string required · Example: 202651890
data.result.result.redirect_url string required · Example: /billing?invoice=51890
data.result.result.skipped array<object> required · Example: []
data.result.result.success boolean required · Example: true

True for successful responses.

data.result.result.timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

data.result.success boolean required · Example: true

True for successful responses.

data.result.timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

data.result.type string required · Example: bulk_renew
data.state string · enum required · Example: completed
active
completed
data.status string · enum required · Example: completed
completed
running
data.statusKey string required · Example: instance.jobs.completed_successfully
data.type string required · Example: bulk_renew
data.vmId string · nullable required · Example: null

Nullable: may be null when not applicable.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/jobs/{jobId}
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/jobs/bulk_renew-1000-1700000000000" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "jobId": "bulk_renew-1000-1700000000000",
    "queueType": "domain",
    "type": "bulk_renew",
    "state": "completed",
    "status": "completed",
    "progress": 100,
    "progressTextKey": "instance.jobs.completed_successfully",
    "progressDetails": {
      "percentage": 100,
      "message": "Operation completed",
      "current": 14,
      "total": 14
    },
    "progressMessage": "Operation completed",
    "result": {
      "success": true,
      "type": "bulk_renew",
      "clientId": "30000",
      "result": {
        "success": true,
        "order_id": 35620,
        "order_number": "313533390",
        "invoice_id": "51890",
        "proforma_id": "202651890",
        "redirect_url": "/billing?invoice=51890",
        "domains_renewed": 14,
        "domains_skipped": 0,
        "skipped": [],
        "timestamp": "2026-02-10T00:00:00.000Z",
        "clientId": "30000"
      },
      "timestamp": "2026-02-10T00:00:00.000Z"
    },
    "isCompleted": true,
    "isFailed": false,
    "isRunning": false,
    "isWaiting": false,
    "createdAt": "2026-02-10T00:00:00.000Z",
    "finishedAt": "2026-02-10T00:00:00.000Z",
    "jobName": "bulk_renew-6832",
    "vmId": null,
    "hostbillAccountId": null,
    "isScheduled": false,
    "delay": null,
    "statusKey": "instance.jobs.completed_successfully"
  }
}