---
title: "Get the current search for a Maps Discovery list"
method: GET
path: "/v1/maps-discovery/lists/{listID}/search"
tags: ["maps-discovery"]
---

# Get the current search for a Maps Discovery list

`GET /v1/maps-discovery/lists/{listID}/search`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/v1/maps-discovery/lists/{listID}/search`
- Auth: API key in header `Authorization`

Returns the list's latest search parameters (location, radius, category) and status so the map can be re-rendered on reopen. Businesses are paged via the results endpoint using the returned request_id.
A list with no search of its own - never searched on, or belonging to another account - gets a null body.

## Path parameters

- `listID` string, required

## Response `200`

The latest search, or null when the list has none

- MapsListSearchResponse
  - `completedAt` string
  - `createdAt` string
  - `foundCount` integer
  - `lastError` string
  - `limitRequested` integer
  - `params` MapsSearchParamsResponse
    - `categories` string[]
    - `language` string
    - `lat` number
    - `limit` integer
    - `lng` number
    - `radiusKm` number
  - `requestID` string
  - `status` string

## Other responses

- `400`: Bad Request

---

[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)