---
title: "Search leads with filters"
method: GET
path: "/api/v3.3/leads"
tags: ["Leads"]
---

# Search leads with filters

`GET /api/v3.3/leads`

One of 'propertyUid', 'agencyUid', 'leadUids' parameters is required. Endpoint will return only those leads which the api client is authorized to access.

## Query parameters

- `propertyUid` string
- `agencyUid` string
- `leadUids` string[]
- `checkInFrom` string, date
- `checkInTo` string, date
- `checkOutFrom` string, date
- `checkOutTo` string, date
- `checkInFromUtcDateTime` string
- `checkInToUtcDateTime` string
- `checkOutFromUtcDateTime` string
- `checkOutToUtcDateTime` string
- `updatedSince` string
- `_limit` integer
- `_cursor` string

## Response `200`

OK

---

[API](https://skmtc.dev/hostfully/apis/hostfully-api.md) · [All operations](https://skmtc.dev/hostfully/apis/hostfully-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hostfully/hostfully-api/revisions/8387ad22afc6/schema)