Report the status of a timestamp-import job: lifecycle state, current phase, per-phase progress, and (on completion) the parse/mutation totals. With no job parameter, reports the current or most recent job. Bearer-token gated: without a configured token the endpoint always returns 401.
Parameters
Output
application/jsonbucketed
boolean
Optional
Whether Phase A+B completed (the offset files are durable).
error
string
Optional
Failure detail; present only when state is failed.
finishedAt
stringdatetime
Optional
Present only for a terminal job.
job
string
Required
Job id.
phase
string
Optional
Current phase: parse_bucket (Phase A+B) or apply (Phase C).
parse_bucket, applyrowsCorruptOffset
integer
Optional
No description available.
rowsMatchedAllVersions
integer
Optional
No description available.
rowsMatchedSpecific
integer
Optional
No description available.
rowsMutated
integer
Optional
No description available.
rowsRejected
integer
Optional
No description available.
rowsTotal
integer
Optional
No description available.
rowsValid
integer
Optional
No description available.
segmentsApplied
integer
Optional
Segments processed so far in Phase C.
segmentsExamined
integer
Optional
No description available.
segmentsPatched
integer
Optional
No description available.
segmentsToApply
integer
Optional
Segments Phase C will process (after resume-skips).
specificCidsUnmatched
integer
Optional
No description available.
state
string
Required
Lifecycle state.
running, complete, failedsubmittedAt
stringdatetime
Optional
An RFC 3339 formatted timestamp.
Errors
JobNotFound
No import job matches the supplied id, or no job has ever run when the id is omitted. Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"description": "Report the status of a timestamp-import job: lifecycle state, current phase, per-phase progress, and (on completion) the parse/mutation totals. With no job parameter, reports the current or most recent job. Bearer-token gated: without a configured token the endpoint always returns 401.",
"errors": [
{
"description": "No import job matches the supplied id, or no job has ever run when the id is omitted.",
"name": "JobNotFound"
}
],
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"bucketed": {
"description": "Whether Phase A+B completed (the offset files are durable).",
"type": "boolean"
},
"error": {
"description": "Failure detail; present only when state is failed.",
"type": "string"
},
"finishedAt": {
"description": "Present only for a terminal job.",
"format": "datetime",
"type": "string"
},
"job": {
"description": "Job id.",
"type": "string"
},
"phase": {
"description": "Current phase: parse_bucket (Phase A+B) or apply (Phase C).",
"knownValues": [
"parse_bucket",
"apply"
],
"type": "string"
},
"rowsCorruptOffset": {
"minimum": 0,
"type": "integer"
},
"rowsMatchedAllVersions": {
"minimum": 0,
"type": "integer"
},
"rowsMatchedSpecific": {
"minimum": 0,
"type": "integer"
},
"rowsMutated": {
"minimum": 0,
"type": "integer"
},
"rowsRejected": {
"minimum": 0,
"type": "integer"
},
"rowsTotal": {
"minimum": 0,
"type": "integer"
},
"rowsValid": {
"minimum": 0,
"type": "integer"
},
"segmentsApplied": {
"description": "Segments processed so far in Phase C.",
"minimum": 0,
"type": "integer"
},
"segmentsExamined": {
"minimum": 0,
"type": "integer"
},
"segmentsPatched": {
"minimum": 0,
"type": "integer"
},
"segmentsToApply": {
"description": "Segments Phase C will process (after resume-skips).",
"minimum": 0,
"type": "integer"
},
"specificCidsUnmatched": {
"minimum": 0,
"type": "integer"
},
"state": {
"description": "Lifecycle state.",
"knownValues": [
"running",
"complete",
"failed"
],
"type": "string"
},
"submittedAt": {
"format": "datetime",
"type": "string"
}
},
"required": [
"job",
"state"
],
"type": "object"
}
},
"parameters": {
"properties": {
"job": {
"description": "Job id returned by importTimestamps. When omitted, the current or most recent job is reported.",
"type": "string"
}
},
"type": "params"
},
"type": "query"
}