# Customer Lifetime Value Calculator API with Visuals

> For the complete documentation index, see [llms.txt](/llms.txt).

Estimate LTV from order value, purchase frequency, gross margin, and lifespan. Includes visual chart data in `result.chart_data` for client-side charts.

Use this endpoint to add the tool to your app, site, workflow, or agent without rebuilding formulas, validation, examples, and docs.

- Slug: `customer-lifetime-value-calculator`
- Category: `marketing`
- Version: `2026-04-22`
- Credits per successful call: 1
- Starts on: free
- Max payload: 65536 bytes
- Privacy mode: `hash_only`
- Available on: free, starter, pro, business, scale

## Endpoint

`POST https://api.miniwebtool.com/v1/tools/customer-lifetime-value-calculator/run`

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `average_order_value` | `float` | no |  |
| `purchase_frequency_per_year` | `float` | no |  |
| `gross_margin_percent` | `float` | no |  |
| `average_customer_lifespan_years` | `float` | no |  |
| `precision` | `int` | no |  |

## Visual chart data

Successful responses include compact `result.chart_data` arrays for rendering charts in Chart.js, Recharts, ECharts, SVG, or canvas without downloading an image.

## Example request

```json
{}
```

## cURL

```bash
curl -X POST https://api.miniwebtool.com/v1/tools/customer-lifetime-value-calculator/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

## Response envelope

```json
{
  "request_id": "01K...",
  "tool": "customer-lifetime-value-calculator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {}
}
```

## Errors

Errors are RFC 7807 `application/problem+json`. Branch on `code`, not `title`.

## MCP

Agents can discover and call this tool through `https://api.miniwebtool.com/mcp` or `https://api.miniwebtool.com/v1/mcp` using MCP `tools/list` and `tools/call`.

## Frequently asked

### What does the Customer Lifetime Value Calculator API do?

Estimate LTV from order value, purchase frequency, gross margin, and lifespan. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.

### How much does one call cost?

1 credit per successful call. Failed calls do not bill.

### What parameters are required?

Required fields: (none). Full schema at `https://api.miniwebtool.com/v1/openapi.json`.

### Does the Customer Lifetime Value Calculator API include visual chart data?

Yes. Use `result.chart_data` to render visual charts client-side without requesting image assets.

### Is this deterministic?

Yes. Same input, same output. Tool version: 2026-04-22.