Tasks

Track the lifecycle of cadastral parcel search tasks.

Endpoints

MethodPathDescription
GET/cadastral/tasksList all parcel search tasks
GET/cadastral/tasks/:idGet task status
GET/cadastral/tasks/:id/summaryGet result counts and failure details

Task lifecycle

StatusDescription
pendingTask created, processing has not started
processingExternal API calls in progress
completedAll points returned parcels
completed_with_errorsSome points succeeded, some failed
failedAll points failed or the task timed out

When to use

  • Inline JSON searches return synchronously with a completed status โ€” you typically don't need to poll
  • File uploads return 202 immediately โ€” poll GET /cadastral/tasks/:id until the status reaches a terminal state
  • List tasks to see all your parcel search history with filtering by status

Required scope: parcels:read