You can view a breakdown of your Soracom usage charges, check past invoices, and analyze costs per IoT SIM through the Billing Dashboard in the User Console.
Billing Dashboard
The Billing Dashboard provides a visual summary of your costs. To access it, log in to the User Console and select Billing Dashboard from the user menu.
The dashboard displays several panels for a high-level overview:
- Recent Billing: Total charges for the last four months (including tax and discounts).
- Costs by Service: Usage charges per service for the selected month (excluding tax).
- Costs per SIM (Top 100): Usage charges for your top 100 SIMs (excluding tax).
- Service Billing: An alphabetical list of usage charges by service.
Billing information is not calculated in real time and may take 12–24 hours to update.
Downloading Invoices and Usage Details
For official records or granular analysis, you can download documents from the Billing & Payment History tab within the Billing Dashboard.
Monthly Invoices (PDF)
Summaries of total account charges for past months are available as PDF files. These are suitable for accounting and tax purposes. For more information, refer to Monthly Invoices.
Detailed Billing (CSV)
For a complete itemized list of charges, you can download a Detailed Billing CSV. This file breaks down charges by day, device (IMSI), service, and option (such as basicCharge or dataTrafficCharge).
To download the CSV:
- Navigate to the Billing & Payment History tab.
- For the current month, click Download service usage charges at the top of the page (provisional data).
- For past months, locate the specific invoice in the list, click the button to the right, and select Download service usage charges.
Analyzing Cost per SIM You can use the CSV file to calculate the exact cost for specific SIMs:
- Open the CSV file in a spreadsheet application like Microsoft Excel.
- Filter the rows based on the IMSI column.
- Sum the amount column to see the total cost for that specific SIM.
Order Invoices
Invoices for devices and products purchased through the User Console are listed separately. See Downloading an Order Invoice for instructions.
Programmatic Access
You can retrieve billing information programmatically using the Soracom API:
- GET /bills/summaries/sims: Retrieves a billing summary per SIM for the last 4 months.
- GET /bills/summaries/bill_items: Retrieves a summary equivalent to the Costs by Service panel.
- GET /bills/latest: Retrieves preliminary usage fees for the current month.
For comprehensive information on billing logic and payment methods, please refer to the Billing documentation.