---
title: "Get Task Status"
method: GET
path: "/searches/{id}/status"
tags: ["Search"]
---

# Get Task Status

`GET /searches/{id}/status`

Retrieve the status of a business search by ID.

## Path parameters

- `id` string, uuid, required — The unique identifier of the search to retrieve the status for.

## Response `200`

Successful Response

- V1BusinessSearchStatusResponse — Represents a business search status response.
  - `id` string, uuid, required — Unique identifier for the business search.
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `error` string, nullable — Any errors that occurred.
  - `warnings` string[] — Any warnings that occurred.
  - `business_url` string, uri, nullable — The API URL to retrieve the business details.
  - `console_url` string, uri, required — The URL to the business search details in the console.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)