---
title: "Plans and pricing"
method: GET
path: "/v1/plans"
tags: ["metadata"]
---

# Plans and pricing

`GET /v1/plans`

## Request

- Base URL: `https://api.close.city`
- URL: `https://api.close.city/v1/plans`
- Auth: none declared

Machine-readable pricing: the free tier's one-time signup grant, the
Close+ membership, and token packs, with sign-up pointers for API clients
and agents. Free, keyless, and static (no database).

## Response `200`

Successful Response

- PlansResponse: GET /v1/plans (routers.meta.plans)
  - `billing_details` string, required
  - `plans` union[], required
    - union
      - FreePlan: The free tier. (routers.meta.plans)
        - `card_required` boolean, required
        - `id` string, required
        - `map_destination_types_at_once` integer, required
        - `name` string, required
        - `price_usd_per_month` integer, required
        - `sign_up` PlanSignup, required: Sign-up pointers for the free tier. (routers.meta.plans)
          - `agent_guide` string, required: Programmatic sign-up guide for API clients and agents
          - `mcp` string, required: MCP server with in-chat sign-up tools
          - `portal` string, required: Account portal (browser sign-up)
        - `signup_grant_tokens` integer, required: One-time API token grant on first sign-in
      - ClosePlusPlan: The Close+ membership. (routers.meta.plans)
        - `cancellation` string, required
        - `id` string, required
        - `map_destination_types_at_once` integer, required
        - `name` string, required
        - `price_display` string, required
        - `price_usd_per_month` integer, required
        - `property_reports_per_day` integer, required
        - `refund_policy` string, required
        - `saved_maps` integer, required
        - `subscribe_url` string, required: Close+ landing page; agents see the docs for the checkout-URL flow
        - `tokens_granted_each_paid_month` integer, required
  - `terms` string, required
  - `token_packs` TokenPack[], required
    - `purchase_url` string, required
    - `tokens` integer, required

---

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