Skip to content
Enjoy complimentary data migration when switching from your existing bookkeeper or CPA to Institution.

Pricing & buying

Estimate API capacity before buying a finance integration

Translate the work your integration will perform into calls, timing and commercial units, then check whether the quoted plan supports normal work and recovery.

By Institution5 minute readPublished View sources
In this guide

An invoice count is only the starting point

A company processing 10,000 invoices does not necessarily make 10,000 API calls. A connector may look up customers, retrieve line details, upload attachments, create records and check the result. Another connector may combine several records in one request. Before buying an integration, ask the provider to explain how your business activity becomes work for each connected service.

Start with the important flows and their timing. List invoice creation, payment updates, contact changes, attachments, reporting extracts and historical imports separately. Note whether each flow runs continuously, on a schedule or only when a user asks for it. That information is more useful than a single monthly transaction total.

Ask for an estimate tied to the proposed design. The provider should state which quantities were measured in a trial and which are assumptions. You are assessing whether the integration can finish the required work within its limits, not demanding a perfectly accurate forecast before configuration begins.

Keep the units distinct

Request the commercial definition of a task, operation, request or transaction wherever the quote uses those terms. The connector platform and accounting application may count different things. A successful workflow can consume several billable operations while also using capacity against the accounting application's API limit.

Xero's API documentation distinguishes concurrent, per-minute, daily and application-wide limits, with daily allowances depending on the app tier. That illustrates why a monthly volume estimate alone cannot establish capacity. Confirm the current limits for the actual connection and plan rather than borrowing a number from an unrelated integration.

Keep a compact unit map in the purchase record. It helps a finance buyer ask precise questions without having to interpret developer logs. If the provider cannot explain which activity consumes which allowance, the proposal is not yet ready for a dependable cost estimate.

Keep the units distinct
MeasureQuestion for the provider
Business eventWhich invoice, payment or update starts work?
Connector operationWhich steps count toward the platform bill?
API requestWhich service receives the call, and which allowance applies?
Elapsed windowBy when must the complete flow finish?
Recovery workWhat additional calls occur after an interruption?

References: Xero: API rate limits

Model a normal day and a catch-up day

Use a hypothetical design to make the arithmetic visible. Suppose 800 new invoices each require three calls and 200 changed payments each require two. That produces 2,800 calls before contact lookups, attachments, status checks or retries. It is a starting estimate for this example, not a recommended integration design.

Now add an interrupted day. If the next morning must process two days of the same activity, that portion becomes 5,600 calls. Ask whether the backlog can be spread across the available window and what work receives priority. A connector that keeps up with an average day may still struggle to recover before the next close deadline.

Include an initial historical load as a separate project quantity. Loading several years of activity can require a different schedule or commercial arrangement from ongoing synchronization. Do not let a large one-time import distort the recurring estimate, or let a recurring quote quietly omit the import altogether.

Check the peak minute as well as the daily total. A scheduled job that starts every flow at once can encounter a short-term limit despite plenty of daily allowance. Ask the implementation provider how it spaces work and how staff can see what remains queued.

Buy visibility into usage and incomplete work

Ask to see the usage information available to your administrator. You should be able to identify the connection, period and relevant allowance, then connect a capacity problem to unfinished business work. A technical counter is useful only if someone can explain what it means for the invoice or payment queue.

Request an operational view of successful, pending and failed records. Clarify whether pending means waiting for capacity, waiting for a dependency or awaiting human correction. Those causes require different responses, and treating all of them as a generic sync error can waste staff time.

Discuss alert ownership. Identify who receives a capacity warning, who can change the schedule and who may approve a different plan. An alert sent only to the consultant who completed the project provides little help after that person has moved to another assignment.

Ask how usage evidence can be retained for a billing question or a recurring incident. You do not need every request stored forever, but a short-lived dashboard may be inadequate when the invoice arrives after its history has disappeared.

Compare efficiency changes with a larger plan

A higher allowance may solve a capacity problem, but it is not the only option. Ask whether the connector can retrieve changed records, avoid unnecessary lookups or combine supported operations. Have the provider explain the effect on correctness and recovery, not just the reduction in calls.

Include the cost of implementing and maintaining a more efficient design. A clever custom workaround that saves a small subscription charge can create a larger support obligation. Conversely, repeatedly purchasing more capacity for avoidable polling may leave the underlying problem untouched.

Treat any proposed redesign as a change to be validated. A reduction in requests should not remove the checks that establish completeness. Compare the resulting record counts and totals against the same prepared workload, including corrections and interrupted processing.

Put the assumptions next to the price

The final quote should identify included volumes, applicable units, required plan tiers and the consequences of exceeding an allowance. Ask whether excess use is blocked, queued or charged, and how a plan change takes effect. These are contract and product questions; do not infer the answer from a general marketing claim about scale.

Record a review trigger, such as adding a new entity, increasing synchronization frequency or introducing attachments. Those changes can affect usage even when invoice volume stays constant. Give the operating owner the estimate and the access needed to compare it with actual consumption.

A sound purchase decision connects the expected workload to both technical limits and the bill. It also leaves a practical route for handling a backlog, because recovery capacity matters when the integration has an imperfect day.

Sources

Requirements and product details can change. Check the linked guidance for the facts that apply to your situation.

Related reading

Need help with this work?

General information, not personalized accounting, tax, legal, or investment advice. Have the appropriate qualified professional review decisions that depend on your circumstances.