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

# Usage and limits

> The two billed units (captured sessions and sessions with replay), what each plan includes, caps and alerts, fair use, the trial, and retention when the plan changes.

This page explains what Apsio counts and what each plan includes. Prices are on the
[pricing page](https://apsio.io/pricing), the only place they are listed.

| | Free | Pro | Enterprise |
| - | - | - | - |
| Plan | No charge, no card | Monthly or annual | Annual contract |
| Captured sessions | 5,000 a month, hard cap | 50k included, then billed per 1,000, for less per 1,000 at higher volumes | By contract |
| Sessions with replay | 500 a month, hard cap | 5,000 included, then billed per 1,000 | By contract |
| Replay per session | Up to 2 minutes: the first and the last | Up to 5 minutes: the first 3 and the last 2 | As on Pro, or as the contract sets |
| Members | 2 | Unlimited | Unlimited, with SSO |
| Projects and apps | 1 project, with its apps | Unlimited | Unlimited |
| Detail retention | 7 days | 30 days | 30 days by default, up to 13 months by contract |
| Crashes and release health retention | 30 days | 13 months | 13 months by default, or as the contract sets |
| [Data export](https://docs.apsio.io/data-export.md) as OTLP files | Included | Included | Included |
| [Rate of change alerts](https://docs.apsio.io/concepts/alerts.md#rules) | None; the other alert rules work | Included | Included |
| SQL queries ([run\_query](https://docs.apsio.io/read-api.md), SQL panels) | None; preset dashboard panels work | 30 a minute | 60 a minute, or as the contract sets |
| Service levels | None | 99.9% for ingest, 99.5% for the console, API and MCP, each month, with credits if missed | As on Pro, or higher in the contract |
| Support | Docs and community | Email | In the contract |

A new organization starts with a 14-day trial of Pro while trials are open (otherwise it starts on
Free): no card, up to 50,000 captured
sessions and 5,000 sessions with replay, with hard caps and never an overage. When it ends, the organization moves to Free
unless you choose Pro. Free and the trial have no service levels; the
[terms of service](https://apsio.io/terms/) describe how availability is measured and the credits.

## Who gets a trial

The trial goes with the email address you verified when you signed up.

* **One per company.** Everyone who signs up with an address at your company's domain shares
  one trial, and a subdomain counts as its domain (`eng.acme.com` is `acme.com`). An
  organization created after the trial was used starts on Free: ask the colleague who
  started it to invite you, or choose Pro.
* **One per person** at a free email provider (Gmail, Outlook and the like) or a university:
  your next organization starts on Free.
* **None from a temporary email address.** Sign up with a permanent one.

An organization without a trial starts on Free and can choose Pro at once. New organizations are also limited
per network, against automated sign-ups.

## Captured sessions

A captured session is a session whose detail is kept by [sampling](https://docs.apsio.io/concepts/sampling.md):
its spans, logs and screens. Users are not metered.

Crashes, errors and the session summaries behind [release health](https://docs.apsio.io/concepts/sessions.md) are
sent from every session, captured or not, within your plan's [fair use](#fair-use). On Free and
during the trial, only the detail stops at the cap: crashes and summaries keep flowing, and there
is never an overage. On Pro, sessions above the included 50k are billed per 1,000.

## Sessions with replay

A session with replay is a captured session that sent at least one
[replay](https://docs.apsio.io/concepts/replay.md) segment. It is the second billed unit.

* **Free:** 500 a month, hard cap. Above it, replay stops for the rest of the month; sessions
  are still captured.
* **Pro:** 5,000 included, then billed per 1,000.
* **Trial:** Pro's numbers under a hard cap, never an overage.
* **Enterprise:** by contract.

A session sends at most 2 minutes of replay on Free and 5 on the other plans, the first and the
last ([how](https://docs.apsio.io/concepts/replay.md#how-much-of-a-session-is-recorded)). To record fewer sessions,
lower replay sampling in the [remote configuration](https://docs.apsio.io/remote-configuration.md).

To capture fewer sessions, lower the session sampling rate in the
[remote configuration](https://docs.apsio.io/remote-configuration.md).

## Caps and alerts

Each billing period counts captured sessions and sessions with replay: the whole 14 days of the trial, then each
calendar month. **Settings › Plan and usage** shows the count against your cap, or against the
included sessions on Pro without one.

* **Caps.** Free stops capturing detail at 5,000 sessions a month and the trial at 50,000.
  On Pro you can set a spend cap, the most a month may cost, in **Settings › Plan and usage**; it is
  optional, and there is none until an owner sets one. At the sessions it pays for, detail capture
  stops the same way. Only owners set it, and raising it resumes capture at once. Devices
  pick the change up at their next policy fetch, so a few more sessions may arrive after
  the cap; they are never billed beyond it.
* **Alerts.** Owners and admins get an email at 50%, 80% and 100% of the cap (or of the
  included sessions), and when a day's sessions jump to ten times the daily average of the
  week before.

## Fair use

Beyond the two billed units, each plan includes this much each calendar month (UTC). None of it
is billed. Enterprise sets its own in the contract.

| | Free | Trial | Pro |
| - | - | - | - |
| Counted sessions (session summaries) | 250,000 a month | 250,000 a month | 7 million a month, or 50 per captured session if that is more, at most 1.25 billion |
| Crash and error records | 50,000 a month | 50,000 a month | 100,000 a month, or 0.25 per captured session if that is more |
| Logs, spans and metric points per captured session | 1,000 on average | 1,000 on average | 1,500 on average |
| OTLP without a session (a backend) | Not included | Not included | 10 GB a month included |
| Stored symbols | 5 GB | 5 GB | 100 GB |

At or near a limit:

* **Counted sessions.** From 95% of the limit, session summaries are sampled at a rate that falls
  from 10% to 0.1% at the limit and stays there, and release health becomes an estimate; the console
  says so. Back under 90% of the limit, every summary is sent again. Detail capture is not affected.
  On Pro the limit rises with the month's captured sessions.
* **Crash and error records.** 10% are sampled while the month stays over the limit, and the first of
  each issue on a device always passes: the SDK keeps the fingerprints it sent this month. So every
  issue is always captured, except under the cost brake below. On Pro the limit rises with captured
  sessions.
* **Telemetry per session.** The limit is an average, counted against at least 1,000 captured
  sessions. From 95% of what the month allows, logs, spans and metrics are sampled that same month,
  down to 0.1%, and owners and admins get a warning. Under 90%, every record is sent again.
* **OTLP without a session.** Records with no `session.id` are refused with HTTP 403
  (`PERMISSION_DENIED`, not retryable): on Free and the trial always, on Pro once the month's 10 GB are used.
  Apsio's SDKs always send `session.id`, so app data is never affected. See
  [Send OTLP](https://docs.apsio.io/send-otlp.md).
* **Stored symbols.** New uploads are refused with HTTP 403 and a clear message. Nothing stored is
  deleted, and symbols no crash needs still [expire](https://docs.apsio.io/concepts/symbols.md) on their own.

**The cost brake.** Sampling asks the SDK to send less; a client that keeps sending anyway meets the
cost brake, on Free, the trial and Pro. Each app key is capped at 60 requests a minute, 50 records a
request and 512 KiB of attachments a minute. Past the whole budget Apsio refuses the organization's
data with HTTP 403 and devices stop sending: at once on Free and the trial, and on Pro only after a
person decides. While either holds, not every issue is captured. Owners and admins are told, and it
lifts at the new month or when Apsio lifts it.

Owners and admins get an email when a limit reaches 80% and when it reaches 100%, once each a
month (on Pro, again for counted sessions if the limit rises), and **Settings › Plan and usage**
shows this month's usage against every limit.

## When the trial ends

At the end of the trial, if you did not choose Pro, the organization moves to Free: capture
goes on within Free's caps, so your apps keep sending crashes and sessions. Data older than
Free's retention is hidden and deleted on its original schedule, and choosing Pro makes what
is still stored readable again.

## Retention when the plan changes

Each row is kept for the retention of the plan it was captured under: detail for the detail
retention, crashes and the session summaries behind release health for theirs. Reads follow
the current plan.

* **Moving to a plan that keeps data for less time.** Data captured under a longer plan is
  hidden within a minute and deleted on its original schedule.
* **Moving to a plan that keeps data for longer.** What is captured from then on is kept
  longer. Data captured before keeps its original schedule, and what is still stored becomes
  readable again within the new plan's retention.
* **Erasure** deletes everything when it runs, whatever the plan (see
  [Privacy and security](https://docs.apsio.io/privacy-and-security.md)).

## Annual plans

An annual Pro plan is paid up front for 12 months. Its price is on the
[pricing page](https://apsio.io/pricing).


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