Get Supplier Confidence Status

Poll the task started by POST /discovery/validate (see Validate Supplier). Poll until status is completed (then fetch GET /discovery/validate/{taskId}/results) or failed.

result carries the geocoded point, with confidence_level: null, as soon as the worker has resolved it, so a caller can show the point while the tier is still computing. It is null before that, and on a task that failed to geocode.

Request

Method & Path

GET /discovery/validate/{taskId}/status

Path parameters

  • taskId (UUID, required) โ€” the task id returned on the 202 (data.id). A non-UUID value is rejected with 400.

Headers

  • x-api-key โ€” required.
  • Accept: application/json

Response

  • 200 โ€” a geocode_confidence_task resource (schema below).
  • 400 โ€” taskId is not a valid UUID.
  • 401 / 403 โ€” missing or invalid key, or the key lacks geocode:read.
  • 404 โ€” the task is unknown, or it belongs to a different organization (404, never 403, so a guessed id cannot be probed).
  • 502 โ€” a transient upstream failure reading the confidence check. Safe to retry.

Response schema

FieldTypeDescription
typestringAlways geocode_confidence_task.
idstringThe task id.
attributes.status"pending" | "processing" | "completed" | "failed"Lifecycle status. Fetch results once completed.
attributes.errorstring | nullFailure message; null unless status is failed.
attributes.error_code"GEOCODE_NO_RESULT" | "GEOCODE_UPSTREAM_ERROR" | nullWhy the task failed: no usable location for the supplier (do not retry), or an upstream failure (retry the POST). null when the task did not fail, or when only the confidence check failed.
attributes.resultobject | nullThe geocode_result attributes so far (see Validate Supplier): the point once geocoded, the full result once completed. Carries the request's company_identifier, if one was sent.
links.resultsstringURL to fetch the finished result.

Required scope: geocode:read