API docs
Guides

Searching restrictions

Learn to search and filter restriction facts across the platform.

Overview

The search endpoint lets you find restrictions across all documents, parcels, and HOAs using flexible filters.

Search for a specific type of restriction:

curl "https://api.setback.io/v1/search/restrictions?fact_type=rental_restriction" \
  -H "Authorization: Bearer YOUR_API_KEY"

Combining filters

Narrow results by combining multiple parameters:

curl "https://api.setback.io/v1/search/restrictions?fact_type=pet_restriction&county=Franklin&min_confidence=0.85" \
  -H "Authorization: Bearer YOUR_API_KEY"

Use the q parameter to search across fact descriptions:

curl "https://api.setback.io/v1/search/restrictions?q=swimming+pool" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filtering by confidence

For production integrations, always set a minimum confidence threshold:

# High confidence only
curl "https://api.setback.io/v1/search/restrictions?min_confidence=0.9"

# Include medium confidence
curl "https://api.setback.io/v1/search/restrictions?min_confidence=0.7"

Pagination

Handle large result sets with pagination:

# First page
curl "https://api.setback.io/v1/search/restrictions?page=1&per_page=50"

# Next page
curl "https://api.setback.io/v1/search/restrictions?page=2&per_page=50"

Check the meta.total field in the response to know how many total results exist.

On this page