Skip to content

Check async job status

GET
/domains/status/{jobId}

Polls the status of an asynchronous domain registration or renewal job.

jobId
required
string

The job ID returned from an async registration or renewal request

Job completed

object
id
required

Job ID

string
status
required
string
Allowed value: completed
type
required

Job type (e.g. “registration”, “renewal”)

string
domain
required
string
years
required
integer
walletAddress
required
string
result
required
object
transactionId
required
string
domain
required
string
years
required
integer
price_usd
required
string
expiresAt
required
string format: date-time
nameServers
required
Array<string>
dnsRecords
required
Array<object>
object
id
required

Unique record identifier

string
type
required

DNS record type

string
Allowed values: A AAAA CNAME MX TXT NS SRV CAA
host
required

Record hostname

string
value
required

Record value

string
ttl
required

Time-to-live in seconds

integer
distance
required

MX priority or SRV weight, null for non-MX/SRV records

integer | null
createdAt
required
string format: date-time
updatedAt
required
string format: date-time

Job is still pending or processing

object
id
required

Job ID

string
status
required
string
Allowed values: pending processing
type
required

Job type (e.g. “registration”, “renewal”)

string
domain
required
string
years
required
integer
walletAddress
required
string
result
required

Null while job is still processing

null
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
poll_interval_ms
required

Recommended polling interval in milliseconds

integer

Job not found

object
error
required

Short error description

string
message
required

Human-readable error message

string
code
required

Machine-readable error code

string
Example
{
"error": "Not found",
"message": "Job not found",
"code": "NOT_FOUND"
}