Skip to content
Guides

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
    Connections
    What it brings
    What each service's API reports: billing, revenue, usage, CI runs, with read-only access where the service has it
  • Source
    Forwarded invoices
    What it brings
    A cost line per confirmed bill, for services with no API
  • Source
    Entered by hand, or sent by you
    What it brings
    Obligations, and a CSV you import (Import a CSV)
  • Source
    Estimates
    What it brings
    A cost worked out as plan price × usage
  • Source
    CI uploads
    What it brings
    Test results, shown in a project's health
  • Source
    Pushed metrics
    What it brings
    Aggregates your own servers send, such as active users
  • Source
    ShipVitals' own checks
    What it brings
    Uptime, TLS and registration of the domains it watches, browser checks, and checks on your runners

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
    API
    It says
    "From the provider's billing API"
  • Tag
    EST
    It says
    "Estimated: plan price × usage"
  • Tag
    INV
    It says
    "From an invoice"
  • Tag
    MAN
    It says
    "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.

How often data syncs

  • Plan
    Free
    Sync
    Daily
  • Plan
    Indie
    Sync
    Hourly
  • Plan
    Studio
    Sync
    Every 15 minutes
  • Plan
    Agency
    Sync
    Every 15 minutes
  • Plan
    Beta (private beta)
    Sync
    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 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.
  • You see
    "so far"
    It means
    The period isn't over yet.
  • You see
    "Complete through Nov 3 · later days so far"
    It means
    Every source is complete through Nov 3. The total also counts what the sources ahead have reported for later days, which can still change.
  • You see
    "Complete through Nov 3 · includes $64.00 from later days so far"
    It means
    On the Costs card: how much of the total those later days add. It equals the chart's days after Nov 3.
  • You see
    "Costs from 8 of 12 projects"
    It means
    Some projects have no source yet; the figure counts only the others.
  • You see
    "Stale since 09:14 · …"
    It means
    The source stopped reporting. The figure is the last known one, muted.
  • You see
    "Backfilling older history · through 2025-03"
    It means
    Older months are still loading.
  • You see
    "First full period ends Nov 24"
    It means
    A source is too new for a full period, so a change isn't meant yet.

See 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.

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.

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.
  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.