# Bondio Help & FAQs

## Docs

- [API Features Availability Per Label](https://docs.bondio.co/api-features-per-label.md): Which API features are supported on each Bondio eSIM label
- [Get prepaid balance of your account](https://docs.bondio.co/api-reference/account-balance/get-prepaid-balance-of-your-account.md): Returns the amount of pre-paid balance in your account
- [List transactions on your account](https://docs.bondio.co/api-reference/account-balance/list-transactions-on-your-account.md): Returns a chronologically sorted list of transactions on the prepaid balance of your account with latest transactions first.
- [Get CDR reports](https://docs.bondio.co/api-reference/cdr-reports/get-cdr-reports.md): Returns the URL to download the daily CDR report file for the specified date. The URL is valid for 10 minutes and can be generated again after expiry by calling this API.
- [Get the coverage profile](https://docs.bondio.co/api-reference/coverage-profile/get-the-coverage-profile.md): Retrieves the coverage profile
- [List coverage profiles](https://docs.bondio.co/api-reference/coverage-profile/list-coverage-profiles.md): Returns the list of coverage profiles available to your account.
- [Get an eSIM](https://docs.bondio.co/api-reference/esim/get-an-esim.md): Retrieve the information of the esim from the given ICCID.
- [Get QR code image](https://docs.bondio.co/api-reference/esim/get-qr-code-image.md): Returns the QR code image in the png format
- [Get SMDP state info of eSIM](https://docs.bondio.co/api-reference/esim/get-smdp-state-info-of-esim.md): **RELEASED** - The esim is ready to be downloaded on the device.
- [List eSIMs](https://docs.bondio.co/api-reference/esim/list-esims.md): Returns a list of eSIMs
- [Set grace period finish action](https://docs.bondio.co/api-reference/esim/set-grace-period-finish-action.md): Sets the action to be taken at the end of grace period. By default it is set to "LAPSE"
- [Archive a plan](https://docs.bondio.co/api-reference/plan/archive-a-plan.md): Archives an existing plan which thereafter cannot be used to create a subscription in future. This is an irreversible operation. An archived plan has a non-null `archivedAt` field. Updating a plan won't impact or modify the existing and historic attachments for this plan
- [Create a plan](https://docs.bondio.co/api-reference/plan/create-a-plan.md): Creates a plan with the given configuration.
- [Delete plan](https://docs.bondio.co/api-reference/plan/delete-plan.md): Deletes plan with the given id. Deleting a plan won't impact the existing and historic attachments for this plan. They will continue to work as expected.
- [Get a plan](https://docs.bondio.co/api-reference/plan/get-a-plan.md)
- [List plans](https://docs.bondio.co/api-reference/plan/list-plans.md): Returns a lists of plans based on the search/filtering criteria
- [Un-archive a plan](https://docs.bondio.co/api-reference/plan/un-archive-a-plan.md): Un-archives a plan so that it can be re-used to create subscriptions. On success, the `archivedAt` field of the plan will be set to null. Calling this operation on an already un-archived plan will return the plan with `archivedAt` set to now.
- [Update plan](https://docs.bondio.co/api-reference/plan/update-plan.md): Updates the plan object according to the provided parameters. Updating a plan a plan won't impact or modify the existing and historic attachments for this plan. They will continue to work as per the original plan paramters at the time of their creation.
- [(deprecated) Get data prices for a coverage profile](https://docs.bondio.co/api-reference/pricing/deprecated-get-data-prices-for-a-coverage-profile.md): Returns the price list of all the countries in a coverage profile
- [(deprecated) List data prices](https://docs.bondio.co/api-reference/pricing/deprecated-list-data-prices.md): Returns the list of the data price applicable to a country in the coverage profile.
- [List data prices V2](https://docs.bondio.co/api-reference/pricing/list-data-prices-v2.md): Returns the list of the data prices per label per country per indicator
- [Create a subscription](https://docs.bondio.co/api-reference/subscription/create-a-subscription.md): Creates a mobile plan subscription with the given plan.
- [Expire a subscription](https://docs.bondio.co/api-reference/subscription/expire-a-subscription.md): Expires a subscription thereby stopping all the services on the attached eSIM. An expired subscription has a non-null `expiredAt` field. This is an irreversible step meaning the same subscription cannot be activated again. Also, the corresponding eSIM cannot be used again.
- [Get a subscription](https://docs.bondio.co/api-reference/subscription/get-a-subscription.md): Retrieves the details of an existing subscription.
- [List addon attachments](https://docs.bondio.co/api-reference/subscription/list-addon-attachments.md): Lists all the addon attachments of a subscription
- [List all subscriptions](https://docs.bondio.co/api-reference/subscription/list-all-subscriptions.md): Return a list of subscriptions. The list is sorted by `createdAt` timestamp with the most recently created subscriptions appearing first.
- [(Topup) Attach an addon to a subscription](https://docs.bondio.co/api-reference/subscription/topup-attach-an-addon-to-a-subscription.md): Attaches an addon plan to an already existing subscription in order to increase its validity and/or data, voice or sms allowance. The subscription should not have expired for it to work.
- [Create a new subscription](https://docs.bondio.co/api-reference/subscriptionv2/create-a-new-subscription.md)
- [Delete a subscription](https://docs.bondio.co/api-reference/subscriptionv2/delete-a-subscription.md): Deletes the subscription and recycles the ICCID associated with it. The associated ICCID goes back into the customer inventory and will be picked up again automatically in the creation of a new subscription at some point in time in future.
- [Get a plan attachment](https://docs.bondio.co/api-reference/subscriptionv2/get-a-plan-attachment.md): The attachment could be in any of the following state:
- [Get a subscription](https://docs.bondio.co/api-reference/subscriptionv2/get-a-subscription.md)
- [Get subscription state info](https://docs.bondio.co/api-reference/subscriptionv2/get-subscription-state-info.md): This is used to fetch the subscription state which can be in any of the following states-
- [Get the location of subscription esim](https://docs.bondio.co/api-reference/subscriptionv2/get-the-location-of-subscription-esim.md): Returns the last known location of a subscription esim. The `currentLocation` field will be `null` until the system sees the esim location for the first time.
- [List plan attachments](https://docs.bondio.co/api-reference/subscriptionv2/list-plan-attachments.md): The attachment could be in any of the following state:
- [List subscriptions](https://docs.bondio.co/api-reference/subscriptionv2/list-subscriptions.md)
- [Send sms](https://docs.bondio.co/api-reference/subscriptionv2/send-sms.md)
- [Suspend a plan attachment](https://docs.bondio.co/api-reference/subscriptionv2/suspend-a-plan-attachment.md): This operation stops all telco services on this attachment and puts it in a suspended state. This is a non-reversible operation. For some providers, this operation is only allowed if the attachment is not yet activated.
- [Suspend a subscription](https://docs.bondio.co/api-reference/subscriptionv2/suspend-a-subscription.md)
- [(Topup) Create a plan attachment](https://docs.bondio.co/api-reference/subscriptionv2/topup-create-a-plan-attachment.md)
- [APN Information](https://docs.bondio.co/apn-information.md): APN configuration details and breakout locations for each label
- [Authentication](https://docs.bondio.co/authentication.md): How to authenticate requests to the Bondio API with API keys
- [Change Log](https://docs.bondio.co/changelog.md): All changes to Bondio's product (dashboard & API) over time
- [Click to Install on Android](https://docs.bondio.co/click-to-install-android.md): Let end users install eSIM profiles from your Android app without scanning a QR code
- [Editable & Deletable Plans](https://docs.bondio.co/editable-deletable-plans.md): Plans are now fully editable — even after they've been used — and can be deleted safely
- [Errors](https://docs.bondio.co/errors.md): HTTP response codes used by the Bondio API
- [Welcome to Bondio Help & FAQs](https://docs.bondio.co/index.md): Guides, troubleshooting, and platform documentation for Bondio eSIM resellers
- [Quickstart](https://docs.bondio.co/introduction.md): Get started with the Bondio API in two steps
- [What is the OMEGA Label?](https://docs.bondio.co/omega-label.md): Bondio's multi-IMSI eSIM label — benefits, pricing, grace periods, and FAQs
- [Unified Label — OMEGA](https://docs.bondio.co/omega-launch.md): Launch announcement for OMEGA, Bondio's unified multi-IMSI eSIM label
- [Pagination](https://docs.bondio.co/pagination.md): Cursor-based pagination for Bondio's list APIs
- [How Plan Validity Works in V1 Subscriptions](https://docs.bondio.co/plan-validity-v1.md): How plan validity periods start, end, and extend via top-ups in V1 subscriptions
- [Raising Support Requests via the Platform](https://docs.bondio.co/raising-support-requests.md): How to submit a support ticket via the Bondio platform, plus SLAs and response expectations
- [SPN Customisation](https://docs.bondio.co/spn-customisation.md): Display your own brand name on the eSIM install screen with a customised Service Provider Name
- [Steps to Test an eSIM](https://docs.bondio.co/test-an-esim.md): A step-by-step walkthrough from ordering eSIM profiles to installing one on your device
- [Bondio Throttling](https://docs.bondio.co/throttling.md): How data throttling works on the Bondio platform, supported labels, and key rules
- [Troubleshooting Your Bondio eSIM](https://docs.bondio.co/troubleshooting-checklist.md): Complete these steps before contacting Bondio Support — most issues resolve in minutes
- [Bondio V2 API](https://docs.bondio.co/v2-api.md): Launch announcement for the Bondio V2 API — recurring plans, throttling, webhooks, and more
- [Voice & SMS in France](https://docs.bondio.co/voice-sms-france.md): Sell voice & SMS enabled eSIMs with French local phone numbers
- [Webhook Events](https://docs.bondio.co/webhooks.md): Receive real-time events from Bondio at your server endpoint

## OpenAPI Specs

- [openapi](https://docs.bondio.co/openapi.yaml)