---
title: "Get maps search job status"
method: GET
path: "/maps-discovery/jobs/{jobID}"
tags: ["maps-discovery"]
---

# Get maps search job status

`GET /maps-discovery/jobs/{jobID}`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/maps-discovery/jobs/{jobID}`
- Auth: `ApiKeyAuth` (a scheme the document does not define)

Fetch the status of a local business search job.

## Path parameters

- `jobID` string, required

## Response `200`

Job status

- MapsSearchJobResponse
  - `categories` string[]
  - `clientRequestID` string
  - `completedAt` string
  - `consumedCredits` number
  - `createdAt` string
  - `error` string
  - `foundCount` integer
  - `jobID` string
  - `language` string
  - `lat` number
  - `limit` integer
  - `lng` number
  - `radiusKm` number
  - `reservedCredits` number
  - `resultsURL` string
  - `status` 'in_progress' | 'completed' | 'failed' | 'no_results'
  - `statusURL` string
  - `updatedAt` string
  - `webhookURL` string

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/leadsforge/apis/leadsforge-api.md) - [All operations](https://skmtc.dev/leadsforge/apis/leadsforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leadsforge/apis/leadsforge-api/revisions/b4a6596215b5?raw)
