---
title: "Get what the caller's plan allows"
method: GET
path: "/me/tier_limits"
tags: ["Account"]
---

# Get what the caller's plan allows

`GET /me/tier_limits`

## Request

- Base URL: `https://findme.photo/api/v1`
- URL: `https://findme.photo/api/v1/me/tier_limits`
- Auth: HTTP bearer

Returns the caller's plan limits and feature flags. `allowed_album_qualities` lists every album quality the plan may use (all options up to `max_album_quality`); use it to pick `album_quality` before `createEvent`. The row is chosen by the account's region (`in` for India, otherwise `us`).

## Response `200`

Plan limits.

- object
  - `data` TierLimits, required
    - `tier` string, required: Internal plan code.
    - `region` 'us' | 'in', required
    - `display_name` string, required
    - `max_albums` integer, nullable, required: null = unlimited.
    - `max_photos_per_album` integer, nullable, required: null = unlimited.
    - `max_storage_gb` integer, required
    - `retention_months` integer, nullable, required
    - `max_album_quality` '800px' | '3000px' | '4000px' | '15mb', required: Stored photo resolution for the album, by long edge: 800px, 3000px, 4000px, or `15mb` (up to 8000 px). Fixed once the album has photos.
    - `allowed_album_qualities` AlbumQuality[], required: Every quality up to `max_album_quality`.
    - `max_video_duration_seconds` integer, required
    - `max_videos_per_album` integer, required
    - `max_video_storage_gb` number, nullable, required: Account video storage cap in GB; null = the plan uses the count/duration limits instead.
    - `has_analytics` boolean, required
    - `has_drive_sync` boolean, required
    - `has_color_scheme` boolean, required
    - `has_branding` boolean, required
    - `has_custom_domain` boolean, required
    - `has_whitelabel` boolean, required
    - `has_ai_assistant` boolean, required: Whether the plan includes API and AI-assistant access.
    - `commission_rate_pct` number, required: Commission on store sales, as a fraction (0-1).
    - `currency` string, required
    - `monthly_price` number, required
    - `annual_price` number, required
  - `meta` Meta, required
    - `request_id` string, required

## Other responses

- `401`: `missing_or_invalid_token` (no or malformed `Authorization: Bearer fm_live_...` header) or `invalid_token` (unknown or revoked key).
- `403`: `tier_not_eligible`: the plan does not include API access (includes `upgrade_url`), or does not include the feature this endpoint needs.
- `429`: `rate_limited` (per-minute limit; `retry_after_seconds`) or `quota_exceeded` (monthly quota; `retry_after_seconds`, `resets_at`).
- `500`: `internal_error`: something failed on our side. Safe to retry reads; include `request_id` when reporting.

---

[API](https://skmtc.dev/findme/apis/findme-photo-api.md) · [All operations](https://skmtc.dev/findme/apis/findme-photo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findme/apis/findme-photo-api/revisions/b68670b742a9?raw)