# How figures are computed

Where each figure in ShipVitals comes from, how fresh it is, and how to check it yourself. A figure never hides what it leaves out, and every card can explain itself.

## Where figures come from

| Source | What it brings | Guide |
|---|---|---|
| Connections | What each service's API reports: billing, revenue, usage, CI runs, with read-only access where the service has it | [Connect a service](connect-a-service.md) |
| Forwarded invoices | A cost line per confirmed bill, for services with no API | [Forward invoices by email](invoice-inbox.md) |
| Entered by hand, or sent by you | Obligations, and a CSV you import (**Import a CSV**) | [Expiries and the calendar](expiries-and-calendar.md), [All services](connect-a-service.md#all-services) |
| Estimates | A cost worked out as plan price × usage | [Costs and budgets](costs-and-budgets.md#the-table) |
| CI uploads | Test results, shown in a project's health | [Send test results and your own metrics](ci-and-push-metrics.md#test-results-from-ci) |
| Pushed metrics | Aggregates your own servers send, such as active users | [Push metrics](ci-and-push-metrics.md#push-metrics) |
| ShipVitals' own checks | Uptime, TLS and registration of the domains it watches, browser checks, and checks on your runners | [Run checks](run-checks.md) |

ShipVitals adds no analytics of its own: usage comes from a connected service or from what you push.

## Source tags on cost lines

On the **Costs** tab, each line's **Source** says how sure it is:

| Tag | It says |
|---|---|
| `API` | "From the provider's billing API" |
| `EST` | "Estimated: plan price × usage" |
| `INV` | "From an invoice" |
| `MAN` | "Entered by hand" |

A confirmed invoice replaces that service's estimate for the same month, so the cost isn't counted twice. When a fifth or more of a card's figure is estimated, the card shows **EST** and how much ("Includes $310 estimated (EST)"). Each line's **Class**, **Variable**, **Fixed** or **Mixed**, comes from the source until you set it: see [Cost classes](costs-and-budgets.md#cost-classes).

## How often data syncs

| Plan | Sync |
|---|---|
| Free | Daily |
| Indie | Hourly |
| Studio | Every 15 minutes |
| Agency | Every 15 minutes |
| Beta (private beta) | Hourly |

The plan also sets how much history shows. When the period is longer, the view bar says so: "History starts Oct 8 · Free keeps 30 days". See [Plans and billing](plans-and-billing.md) and **/pricing**.

## What a card tells you

The line at the end of the view bar says how fresh the figures are: "Updated 03:39 AM · Costs complete through Nov 3". The date shows only when a source is behind. On a card:

| You see | It means |
|---|---|
| "—" | Nothing is known, or the amount is hidden from you. Never 0. |
| "so far" | The period isn't over yet. |
| "Complete through Nov 3 · later days so far" | Every source is complete through Nov 3. The total also counts what the sources ahead have reported for later days, which can still change. |
| "Complete through Nov 3 · includes $64.00 from later days so far" | On the Costs card: how much of the total those later days add. It equals the chart's days after Nov 3. |
| "Costs from 8 of 12 projects" | Some projects have no source yet; the figure counts only the others. |
| "Stale since 09:14 · …" | The source stopped reporting. The figure is the last known one, muted. |
| "Backfilling older history · through 2025-03" | Older months are still loading. |
| "First full period ends Nov 24" | A source is too new for a full period, so a change isn't meant yet. |

See [What a figure tells you](portfolio-dashboard.md#what-a-figure-tells-you).

## What Explain shows

Press a card, or tab to it and press `e`. The sheet lists **What it is**, **How it was computed** (the sum with its numbers), **What it's made of** (usually one row per project, with **Unallocated** and **Not yet split**), **Coverage and freshness**, **Conversions** and **See the rows →**. See [Explain a figure](portfolio-dashboard.md#explain-a-figure).

## Shared costs

A resource that serves several projects is **Shared**. Its split has a **Method**:

- **Equal**: the same share each.
- **Fixed %**: a share per project. When the shares add up to less than 100%, the rest goes to **Unallocated**.
- **Usage-weighted**: by what the service measures, such as messages sent per project.

A split applies from today, or to past months too if you tick **Apply to past months too**. On **Costs**, **Allocation** names the share, such as "40% of Upstash · fixed share". See [Split a shared resource](review-bindings.md#split-a-shared-resource).

## Currencies

A figure that includes a conversion reads "≈" in Explain's title, and **Conversions** lists the rates used. Amounts in a currency with no rate yet are left out until one is in: "EUR amounts not converted: no rate."

## Revenue without your customers' details

ShipVitals stores revenue totals, not customers. It never stores your customers' names, emails or card details: revenue is counted against a hashed customer id. See **/security**.

## Check a figure yourself

1. Press the card for Explain, then **See the rows →** for the rows behind it.
2. Press the freshness line for **Sources**: each source and how far it's complete ("Stripe · through Nov 4").
3. Press **Show as table** under a chart, or **Table actions → Export CSV** on the projects table. See [Read a chart](portfolio-dashboard.md#read-a-chart).
4. Read the same figure through the API, `GET /api/v1/public/portfolio?period=30d`, with a read-only token. Amounts come in the currency's minor units. See [Call the REST API](api-tokens.md#call-the-rest-api).
