---
title: "Get published pricing & promotions"
method: GET
path: "/v1/pricing"
tags: ["Agent Contract"]
---

# Get published pricing & promotions

`GET /v1/pricing`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/pricing`
- Auth: none declared

This field follows the Loppee v3 Verified and Listed contract.

## Response `200`

PricingResponse

- PricingResponse
  - `generated_at` string, date-time, required
  - `source` 'published' | 'default', required
  - `revision_id` string, nullable, required
  - `published_at` string, nullable, required
  - `currency` 'USD', required
  - `billing` object, required
    - `periods` string[], required
    - `annual_paid_months` number, required
    - `annual_rule` string, required
  - `plans` PricingPlan[], required
    - `key` 'free' | 'nearby' | 'local' | 'regional' | 'metro', required
    - `name` string, required
    - `tagline` string, required
    - `reach_label` string, required
    - `monthly_usd` number, required
    - `annual_usd` number, required
    - `features` string[], required
    - `badge` string, required
    - `unlocks_deals` boolean, required
    - `promo` PricingPlanPromotion, required
      - `id` string, required
      - `label` string, required
      - `banner_text` string, required
      - `coupon_code` string, nullable, required
      - `applies_to_period` 'all' | 'monthly' | 'annual', required
      - `ends_at` string, nullable, required
      - `promo_monthly_usd` number, required
      - `promo_annual_usd` number, required
  - `branch_add_ons` PricingBranchAddOn[], required
    - `radius_max_miles` number, required
    - `monthly_usd` number, required
    - `annual_usd` number, required
  - `radius_extension` object, required
    - `beyond_miles` number, required
    - `max_miles` number, required
    - `per_mile_monthly_usd` number, required
  - `promotions` PricingPromotion[], required
    - `id` string, required
    - `label` string, required
    - `banner_text` string, required
    - `discount_type` 'percent' | 'fixed', required
    - `percent_off` number, nullable, required
    - `amount_off_usd` number, nullable, required
    - `coupon_code` string, nullable, required
    - `applies_to_period` 'all' | 'monthly' | 'annual', required
    - `applies_to_tiers` string[], required
    - `starts_at` string, nullable, required
    - `ends_at` string, nullable, required
  - `neutrality` string, required
  - `trust_model_version` 'v3', required

## Other responses

- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)