Skip to main content
GET
Poll an acquisition

Path Parameters

id
string<uuid>
required

Request ID from POST /api/v1/data/requests.

Response

Current acquisition state.

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
status
enum<string>
required
Available options:
queued,
acquiring,
normalizing,
validating,
publishing,
ready,
failed
coverageDigest
string
required
Pattern: ^[a-f0-9]{64}$
target
object
required
datasetVersion
string | null
required
Pattern: ^[a-zA-Z0-9_-]{1,128}$
error
object | null
required
createdAt
string
required
updatedAt
string
required
cache
string
Allowed value: "miss"
created
boolean

False when an identical in-flight or recent acquisition was reused.

job
object | null
events
object[]