GET /voyage/{task_id} returns the current state of a voyage your organization
requested. Poll every five minutes or slower while a voyage is active.
Request
Path parameters
string
required
taskId returned by POST /voyage.Example
Response
string
required
Stable task identifier.
string
required
Normalized registrable domain.
"queued" | "running" | "in_review" | "completed" | "failed" | "cancelled"
required
Machine-readable voyage status.
"discovering_site" | "sampling_products" | "building_extraction" | "in_review" | "publishing_catalog" | "complete" | "failed"
required
Current pipeline phase.
string
required
Human-readable label for the current phase.
integer
required
Monotonic progress value from 0 to 100.
datetime | null
When the voyage was created.
datetime | null
When the voyage state was last updated.
datetime | null
When the voyage reached a terminal state.
object | null
Populated when the voyage fails, with a stable
code and safe message.object | null
Populated when the catalog is live. Includes
catalog, productCount, and
the supported search and lookup endpoint paths.