---
title: "Limits and freshness"
description: "Rate limits and listing freshness"
status: "preview"
canonical_url: "https://fairwayrent.ai/docs/agents/limits"
last_updated: "2026-11-18"
related:
  - "/agents"
  - "/docs/agents/tools"
audience: "agents, developers"
---

> For AI agents: This page describes the Fairway preview. The MCP endpoint is coming soon.

# Limits and freshness

Rate limits and a caching window are pending publication. No MCP endpoint is live yet.

## Access tiers

Anonymous search is planned with a tighter limit. Registered search is planned with higher limits. In the service in development, a call without an API key gets fewer results per page and a lower rate limit than a call with a key. A call over a limit gets a rate-limit error with a `Retry-After` header. We will publish the exact values when available; do not build a client around a guessed number.

## Freshness

The preview schemas include `checked_at`. Availability, rent, fees, and policies can change after that timestamp. Refresh a known listing before making a consequential recommendation and show the renter its Fairway link.

## Caching

Caching will be allowed within a published window. The duration is still open. Until it is published, do not assume a cache lifetime. See [tool previews](/docs/agents/tools).
