> ## 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 results

> Page through enriched businesses, including partial results from an active job.

Returns businesses already imported for the job. Results are available while discovery and enrichment continue; the same rows appear live in the Mapsdata UI.

<ParamField path="search_id" type="string" required>UUID returned as `job_id` by `POST /searches`.</ParamField>
<ParamField query="page" type="integer" default="1">Page number, starting at `1`.</ParamField>
<ParamField query="page_size" type="integer" default="100">Businesses per page, from `1` to `500`.</ParamField>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "job_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
    "status": "enriching",
    "items": [
      {
        "id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
        "search_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
        "position": 1,
        "title": "Hudson Plumbing & Heating",
        "category": "Plumber",
        "address": "221 W 37th St, New York, NY 10018",
        "city": "New York",
        "phone": "+12125550184",
        "website": "https://hudsonplumbing.example",
        "rating": 4.7,
        "review_count": 186,
        "business_status": "OPERATIONAL",
        "rank": 1,
        "categories": ["Plumber", "Heating contractor"],
        "country_code": "US",
        "google_maps_url": "https://www.google.com/maps?cid=8182443519000000000",
        "owner_name": "Elena Torres",
        "owner_names": ["Elena Torres"],
        "decision_maker_names": [],
        "emails": ["service@hudsonplumbing.example"],
        "owner_emails": ["elena@hudsonplumbing.example"],
        "decision_maker_emails": [],
        "email_verification_status": "completed",
        "email_verifications": {
          "elena@hudsonplumbing.example": {
            "result": "ok",
            "quality": "good",
            "source": "anymailfinder"
          }
        },
        "socials": {"facebooks": [], "instagrams": [], "linkedIns": [], "youtubes": [], "yelps": []},
        "additional_phones": [],
        "phone_types": {"+12125550184": "landline"},
        "enrichment_status": "completed",
        "owner_enrichment_status": "completed",
        "key_contacts": []
      }
    ],
    "total": 74,
    "page": 1,
    "page_size": 500,
    "has_more": false
  }
  ```
</ResponseExample>

## Pagination and live data

During an active job, `total`, contact fields, and verification fields can change between requests. Treat each response as a current snapshot. When the search reaches a terminal status, fetch from page 1 again and continue until `has_more` is `false`.

<div className="callout mint-my-5 mint-rounded-xl mint-border mint-border-[#656c2e]/30 mint-bg-[#656c2e]/10 mint-px-5 mint-py-4 mint-text-sm mint-text-[#4d5321]">
  An email in <code>emails</code>, <code>owner\_emails</code>, or <code>decision\_maker\_emails</code> is not automatically verified. Inspect <code>email\_verification\_status</code> and the address entry in <code>email\_verifications</code> before use.
</div>

See [Data fields](/docs/reference/data-fields) for the complete lead shape.


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