1. Overview
Rate limits keep P3RSON stable and fair for everyone. They match the Terms of Service, Section 3.10. If anything here differs from the Terms, the Terms control.
2. Limits
Limits apply per signed-in user in a rolling 60-second window.
| Tier | Limit | Used for |
|---|---|---|
| Default | 20 requests per minute | Feed, profiles, search, bookings, notifications, discovery |
| Burst | 60 requests per minute | Messaging and read operations |
| Strict | 5 requests per minute | Sign-in, account deletion, refunds, disconnecting Stripe, data export, starting a dispute, admin actions |
Requests that are not signed in (sign-up, password reset, public profile views) are limited per IP address.
3. When You Hit a Limit
The server returns HTTP 429 (Too Many Requests) with a Retry-After header giving the seconds to wait. Responses also include X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset-After headers. Wait for the time given and retry. Use exponential backoff if it happens repeatedly.
4. Analytics Batches
The analytics batch endpoint accepts up to 50 events per request. A larger batch is rejected with a 400 error. Each event counts toward the limit.
5. Fair Use
Do not abuse limits to degrade the service, scrape the platform, share API access with others, get around limits with multiple accounts or IP addresses, or attack the service. Violations follow the progressive discipline steps in the Community Guidelines and may lead to suspension or termination.
6. Availability
We aim for high availability of booking, messaging and payment endpoints and announce planned maintenance at least 48 hours ahead. The Terms of Service, Section 3.10 states what we commit to. Downtime is not a ground for credits or refunds unless the Terms say so.
7. Requesting Higher Limits
Email [email protected] with your use case and expected volume. We reply within 5 business days. We may grant higher limits for legitimate business use by Agency and Brand customers.
8. Changes
We may change limits. Decreases are announced at least 30 days ahead by email and in the app. Increases take effect when posted.