---
title: "Bulk Get Prospects"
method: POST
path: "/v1/prospect/bulk-search"
tags: ["Prospect"]
---

# Bulk Get Prospects

`POST /v1/prospect/bulk-search`

## Request

- Base URL: `https://api.eliseai.com`
- URL: `https://api.eliseai.com/v1/prospect/bulk-search`
- Auth: none declared

Fetch multiple prospects by ID list or by property + contact filter

## Request body

- BulkGetProspectsRequest
  - `elise_prospect_ids` string[]: List of Elise prospect IDs to fetch. Provide either this or elise_property_id with email/phone.
  - `elise_property_id` string: Elise property ID. Required when filtering by contact information.
  - `email` string: Prospect email address.
  - `phone` string: Prospect phone number.
  - `status` 'Inquiry' | 'Applicant' | 'Leased' | 'Cancelled': An enumeration.
  - `created_after` string, date-time: Return prospects created at or after this datetime (UTC, inclusive).
  - `created_before` string, date-time: Return prospects created at or before this datetime (UTC, inclusive).

## Response `200`

Successful Response

- EliseProspect[]
  - `elise_prospect_id` string, required
  - `elise_property_id` string, required
  - `status` 'Inquiry' | 'Applicant' | 'Leased' | 'Cancelled': An enumeration.
  - `first_name` string
  - `last_name` string
  - `email` string
  - `phone` string
  - `preferred_layouts` string[]
  - `preferred_units` string[]
  - `primary_lead_source` string
  - `from_move_in_date` string, date
  - `to_move_in_date` string, date
  - `min_lease_length` integer
  - `max_lease_length` integer
  - `min_budget` integer
  - `max_budget` integer
  - `pets` Pets[]
  - `pms_external_prospect_id` string
  - `pms_external_prospect_source` string
  - `external_property_id` string
  - `prospect_time_created` string, date-time

## Other responses

- `401`: Not Authorized for this endpoint
- `404`: Not found
- `422`: Validation Error

## Changes

> 57 revisions in range; 2 not diffed.

- **2026-10-02** `a0e48cae79d4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/eliseai/apis/elise-api/changes/v1/prospect/bulk-search/post.md)

---

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