Skip to main content

FAQ

Answers to common questions about the Zentari Axis API.

General​

What is the Axis Platform?​

The Axis Platform is Zentari's web-based dashboard for managing your SIM and eSIM estate. It provides the same capabilities as the API via a visual interface, making it easy for non-technical team members to monitor usage, activate SIMs, and generate reports. The API and Axis Platform operate on the same data in real time.

Do I need an account to use the API?​

Yes. API keys are tied to a Zentari Networks account. Contact sales@zentarinetworks.com to get started, or ask your account manager for API access if you're an existing customer.

Authentication​

My API key stopped working. What do I do?​

API keys can be revoked if there is suspected unauthorized use, if your account subscription has lapsed, or if you manually rotated the key. Log in to the Axis Platform, navigate to Settings → API Keys, and generate a new key. Contact support if your account appears locked.

Can I have multiple API keys?​

Yes. You can create multiple keys with different scopes — for example, a read-only key for analytics dashboards and a write-enabled key for your provisioning service. This limits the blast radius if a key is compromised.

SIM Management​

What is an ICCID?​

The ICCID (Integrated Circuit Card Identifier) is the unique 18–22 digit serial number printed on a physical SIM card. It is the primary identifier used in API requests. For eSIMs, the EID (eUICC Identifier) is used for profile management.

Can I reactivate a terminated SIM?​

No. Termination is permanent and irreversible. Use the SUSPENDED state to temporarily block a SIM if you may need to reactivate it in the future.

How quickly do state changes take effect?​

In most cases, state changes (activate, suspend) take effect within 30 seconds. In rare cases involving network-side propagation, it may take up to 5 minutes. Subscribe to the sim.state_changed webhook to receive a notification once the change has fully propagated.

What happens when a SIM hits its data limit?​

Depending on your configuration, the SIM will either be suspended (all connectivity blocked) or throttled (reduced to a low speed). Configure the action_on_limit field when setting data limits. You'll also receive a sim.data_limit_reached webhook event.

eSIM & eUICC​

What devices support eSIM profile swaps?​

eSIM profile swaps (OTA) are supported on devices with an eUICC chip that complies with the GSMA RSP specification. This includes most modern smartphones, many IoT modules (e.g. Sierra Wireless HL78, Quectel BG95-M3), and industrial routers.

How long does an OTA profile swap take?​

Profile downloads typically complete within 60 seconds of the device connecting to the network. You can subscribe to the profile.downloaded webhook to receive a notification when the download is confirmed.

Connectivity​

Which countries and networks are supported?​

Zentari's multi-network roaming covers 190+ countries and 600+ networks. See the Networks section and use the Networks API to retrieve the full list available to your account.

Can I use a private APN?​

Yes. Zentari supports private APNs and fixed IP addressing for customers who require a secure, isolated network segment. Contact support@zentarinetworks.com to configure a private APN.

Billing & Support​

How is usage billed?​

Usage is billed per MB consumed, with rates varying by country and network. Your Zentari account manager can provide a detailed rate card. Usage data is available in real time via the API and Axis Platform dashboard.

How do I get technical support?​

  • Email: support@zentarinetworks.com
  • Platform: Raise a ticket directly from the Axis Platform dashboard
  • Enterprise: Dedicated support channel — contact your account manager

Response times vary by support tier. Enterprise customers have access to 24/7 priority support.