> ## Documentation Index
> Fetch the complete documentation index at: https://www.mapsdata.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get search status

> Read live job state, counts, billing, and terminal errors.

Poll this endpoint every 5–10 seconds. A job is terminal when status is `completed` or `failed`.

<ParamField path="search_id" type="string" required>
  UUID returned as `job_id` by `POST /searches`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://www.mapsdata.io/api/v1/searches/c15dbb36-5a56-4720-b1af-b388bcaf78dc" \
    -H "x-api-key: md_live_your_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
    "name": "New York plumbers",
    "status": "enriching",
    "actor_input": {
      "query": "plumbers",
      "location": "New York, New York",
      "countryCode": "US",
      "maxResults": 100,
      "language": "en"
    },
    "source": "apify",
    "origin": "api",
    "run_id": "provider-run-id",
    "error": null,
    "lead_count": 74,
    "credits_charged": 100,
    "enrich_contacts": true,
    "enriched_count": 51,
    "delete_requested": false,
    "created_at": "2026-10-01T09:12:30Z",
    "finished_at": null
  }
  ```
</ResponseExample>

<ResponseField name="status" type="string">One of `queued`, `starting`, `running`, `importing`, `enriching`, `completed`, or `failed`.</ResponseField>
<ResponseField name="lead_count" type="integer">Businesses imported so far. This can increase while the job is active.</ResponseField>
<ResponseField name="enriched_count" type="integer">Businesses whose contact enrichment has completed.</ResponseField>
<ResponseField name="credits_charged" type="integer">Credits reserved when the job was created.</ResponseField>
<ResponseField name="error" type="string | null">Terminal failure explanation when available.</ResponseField>

Do not wait for completion before presenting results. Fetch `GET /searches/{search_id}/results` during `running`, `importing`, and `enriching` to read businesses already found.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.