Skip to content
All articles

Getting started with API integration

A general plan for technical suppliers looking to automate their work with SimAggregator through the API: what to prepare, what logic to build in, and in what order to connect things.

What to prepare before you start

The API needs the same verified supplier account used for the cabinet. If you're planning to sell rentals, a day, three days, or a week, in addition to activations, long-term rental access must be turned on separately for the account; without it, those orders aren't available through either the cabinet or the API.

Next, decide what to bring into your system first: number statuses, orders, prices, or accruals. The more devices and services involved (SimAggregator's catalog lists 3,000+), the bigger the automation payoff, but it's best to start with one task.

What logic to build in

The platform has two order types: activation (one service, 20 to 60 minutes) and rental (a day, three days, or a week, for one service or the whole number with all incoming SMS). Refund rules differ: an activation is refunded if the code never arrives, while a rental of a day or longer generally stops being refundable after the first hour. Build this distinction into your revenue accounting from the start.

A number isn't always available for sale: it may be tied up in an active whole-number rental, sitting in the cooldown that follows one, or be a new SIM still in its whole-rental-only window. Buying it again after the term ends counts as a new order. If your integration decides on its own when to list a number, factor in these states alongside the device's own status.

What order to connect things in

Connect in a logical order: pull observational data in first, device and number statuses, order history, accruals, then move to actions like adjusting prices within the corridor the platform keeps. The accrual lands as soon as the order is paid for; withdrawal is a separate request, worth tracking apart from the integration itself.

A gradual rollout lowers the risk: test part of the process on a small number of numbers while the rest keeps running through the cabinet.

Already working with another platform?

Connect the same SIMs to SimAggregator and switch your price bot on the hero-sms or smsbower slider protocol by changing the address.

How to switch →

Start earning with your SIM cards

Sign up and connect your hardware in 10 minutes. Your first sales happen the same day.