> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cuprice.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing Plans

> Get plans and features for any project (public, no auth required)

Returns all visible pricing plans with features for a project. This is the API that powers the billing widget (`data-cuprice-billing`).

**No authentication required** — plan data is public.

**shareId** `string` *required*

The project's Share ID (from the Cuprice dashboard after publishing).

## Response

```json theme={null}
{
  "project": {
    "id": 42,
    "name": "My SaaS",
    "currency": "USD",
    "handoffBaseUrl": "https://yoursite.com/checkout",
    "handoffMethod": "redirect"
  },
  "plans": [
    {
      "id": 100,
      "name": "Starter",
      "description": "For individuals",
      "monthlyPrice": 0,
      "annualPrice": 0,
      "isFree": true,
      "isPopular": false,
      "order": 0,
      "features": [
        {
          "id": 1,
          "name": "Projects",
          "description": "Number of projects",
          "included": true,
          "limit": 3,
          "isCountable": true,
          "multiplier": 3
        }
      ]
    }
  ],
  "annualDiscount": 0.2,
  "annualDiscountEnabled": true
}
```

## Rate limiting

60 requests per minute per IP address.

## Example

```bash theme={null}
curl https://app.cuprice.io/api/billing/public/YOUR_SHARE_ID
```

```javascript theme={null}
const res = await fetch("https://app.cuprice.io/api/billing/public/YOUR_SHARE_ID");
const { plans, annualDiscount } = await res.json();
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.