Your integrator.io subscription sets which features your account can use and how much of each metered resource, called an entitlement, it can consume: flows run, endpoints invoked, API calls, AI actions and credits, MCP calls, lookup cache units, file storage, and more. This article explains where to see your plan and usage, how the usage display works across environments, what each entitlement measures, and what happens when you go over a limit. The counting rules for each entitlement are in their own articles, linked from the table below.
Prerequisites: You must be the account owner or an administrator.
Note: Current and historical usage data is available on the 2024 Platform license. On the 2022 Endpoint license, usage data isn't stored or displayed in integrator.io. To upgrade, contact Celigo Support.
View your subscription and usage
-
Go to Account
, and then select Subscription. In a multiple-environment account, select the environment at the top of the page first.
- Review the page:
- Plan details – Status, expiration date, customer success plan, and the premium features included in your plan (see Plan features).
- Entitlements usage – Your base allowances, with any add-ons listed beneath them (for example, + 5000 add-on integration flows), and then each metered entitlement as used versus allocated for the current month or year; the allocated figure includes add-ons. Usage can take a few minutes to update.
- Select View next to an entitlement to open its details: a real-time breakdown of current usage and, where available, usage by month. Some details can be filtered, for example by environment.
- To add features or raise a limit, select Request upgrade.
How usage is shown across environments
Each usage bar shows the total for the whole account, not for the environment you're viewing. If production used 50 API calls and a sandbox used 10, every bar shows 60.
- Production-only accounts – The bar is your total usage.
- Multiple-environment accounts – To see one environment's share, select View and filter by environment, or switch environments at the top of the page.
- Legacy production/sandbox accounts – If your plan has separate production and sandbox entitlements, you see a bar for each, but both show the account total. Entitlements aren't shared between production and sandbox; unused sandbox allowance can't cover a production overage.
The rows you see depend on your plan; an entitlement that isn't in your plan isn't listed. For free trial accounts, usage isn't counted during the 30-day unlimited period.
Plan features
Features are on or off for your plan rather than metered. The Subscription page lists the ones your plan includes.
| Feature | Description |
|---|---|
| API builder | Build and manage custom APIs that external systems call with an API token. |
| API management (Advanced) | Build, secure, publish, monitor, and retire APIs through the API Management gateway. |
| Audit log retention | Keep audit logs for one, two, or three years. |
| B2B Manager (Basic or Advanced) | Manage EDI transactions. The Advanced tier adds capabilities for managing EDI at scale. |
| B2B shipping labels | Generate shipping labels with the B2B Shipping Labels (powered by BarTender) connector. |
| CDC | Capture changed records from a database as they happen. |
| Data retention (up to 180 days) | Keep flow data for 60, 90, or 180 days instead of the default 30. |
| Data Ingestion | Load data from hundreds of applications into your data warehouse with Celigo sync. |
| File storage | Store files in Celigo Storage for your flows to read and write. |
| Lookup cache | Store frequently used data centrally for fast lookups across flows. |
| Sandbox or multiple non-production environments | Build and test outside production. |
| Single sign-on (SSO) | Let users sign in with your identity provider. |
| Topics | Publish messages to topics and let flows subscribe to them. |
| AI agents | Build agents that understand tasks and take action in your integrations. |
Features that aren't metered are managed on their own pages; for example, stored audit logs are reviewed on the Audit logs page.
What is metered
Entitlements are counted separately for production and sandbox when your plan includes both. Each entitlement has its own counting rules, explained in the linked article.
| Entitlement | What counts | Details |
|---|---|---|
| Flows run | Each distinct flow or flow instance that runs in a month, whatever its final status. Running the same flow again doesn't add to the count. | Track your flow usage |
| Endpoints invoked | Each distinct app, database, or universal connection that a flow run, API call, or standalone invoke reaches. | Track your endpoint usage |
| On-premise agents used | Each agent included in a flow that runs or in a connection's API call, for example a Microsoft Active Directory connection that requires an agent. | On-premise agents |
| Environments enabled | The number of active non-production environments. | Multiple environments overview |
| EDI trading partners | The number of trading partners set up in B2B Manager. | B2B Manager licensing tiers |
| EDI document types | The number of distinct EDI document types in use. | B2B Manager licensing tiers |
| B2B shipping labels | Each label generated by the B2B Shipping Labels (powered by BarTender) connector, per week. | Track your B2B shipping label usage |
| API calls | Each direct or fully managed call to a custom API, a registered APIM API, or a standalone resource, per month. | Track your API usage |
| DI volume | Each record Celigo sync loads to the destination in a run, insert or update, per month. | Celigo sync overview |
| AI actions used and AI credits remaining | Tool executions by AI agents and calls to your MCP servers, and the AI processing agents use. | Track your AI agent actions, credits, and MCP call usage |
| Lookup cache | Read and write requests to lookup caches, in units, per month. | Track your lookup cache usage and limits |
| File storage | The space your files use in Celigo Storage. | Celigo Storage |
| MCP calls (plans that include MCP) | Each tool, prompt, or resource invocation received by an MCP server published in your account. | Track your AI agent actions, credits, and MCP call usage |
Note: On legacy endpoint-priced subscriptions, flows in an integration app are included in the app's subscription and don't count toward Flows run, although their connections still count as endpoints. Trading partners are counted by distinct FTP or AS2 server name or IP address.
When you exceed an entitlement
You're notified by email as you approach, reach, and exceed an entitlement. For most entitlements the limit is soft: flows keep running and calls aren't blocked. An entitlement with a fixed maximum, such as EDI trading partners, shows Maximum reached with a Request upgrade button when you've used all of it. The exceptions are enforced balances:
- API calls – A rate limit applies above the entitlement (see Track your API usage).
- AI credits – Agents stop running when the balance reaches zero (see Track your AI agent actions, credits, and MCP call usage).
If your usage is consistently over a limit, select Request upgrade on the Subscription page or contact your account team. Before reducing a subscription, check your usage, because entitlements beyond the new limit are disabled when the change takes effect (see Track your endpoint usage).