--- description: Capacitor plugin to read SIM card and carrier information such as carrier name, country code, MCC, and MNC on Android. title: Capacitor SIM Plugin for Android - Capawesome image: https://capawesome.io/docs/assets/images/social/sdks/capacitor/sim.png --- [Skip to content ](#capacitor-sim-plugin) [πŸ–₯️ Introducing the **Capacitor Electron Platform** β€” build desktop apps for macOS, Windows, and Linux. Free & open source. ](/blog/announcing-the-capacitor-electron-platform/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ Gyroscope ](/docs/sdks/capacitor/gyroscope/) * [ Haptics ](/docs/sdks/capacitor/haptics/) * [ Home Indicator ](/docs/sdks/capacitor/home-indicator/) * [ In-App Browser ](/docs/sdks/capacitor/in-app-browser/) * [ Install Referrer ](/docs/sdks/capacitor/install-referrer/) * [ Intercom ](/docs/sdks/capacitor/intercom/) * [ Intune ](/docs/sdks/capacitor/intune/) * [ Keep Awake ](/docs/sdks/capacitor/keep-awake/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Light Sensor ](/docs/sdks/capacitor/light-sensor/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Localization ](/docs/sdks/capacitor/localization/) * [ Mail Composer ](/docs/sdks/capacitor/mail-composer/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Maps Launcher ](/docs/sdks/capacitor/maps-launcher/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ Network ](/docs/sdks/capacitor/network/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ Node.js ](/docs/sdks/capacitor/nodejs/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Passkeys ](/docs/sdks/capacitor/passkeys/) * [ Password Autofill ](/docs/sdks/capacitor/password-autofill/) * [ PDF Generator ](/docs/sdks/capacitor/pdf-generator/) * [ PDF Viewer ](/docs/sdks/capacitor/pdf-viewer/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Permissions ](/docs/sdks/capacitor/permissions/) * [ Phone Dialer ](/docs/sdks/capacitor/phone-dialer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ Photo Manipulator ](/docs/sdks/capacitor/photo-manipulator/) * [ PixLive ](/docs/sdks/capacitor/pixlive/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Privacy Screen ](/docs/sdks/capacitor/privacy-screen/) * [ Proximity Sensor ](/docs/sdks/capacitor/proximity-sensor/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Root Detection ](/docs/sdks/capacitor/root-detection/) * [ Screen Brightness ](/docs/sdks/capacitor/screen-brightness/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screen Reader ](/docs/sdks/capacitor/screen-reader/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Settings Launcher ](/docs/sdks/capacitor/settings-launcher/) * [ Shake ](/docs/sdks/capacitor/shake/) * [ Silent Mode ](/docs/sdks/capacitor/silent-mode/) * SIM [ SIM ](/docs/sdks/capacitor/sim/) * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Type Aliases ](#type-aliases) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) * [ SMS Composer ](/docs/sdks/capacitor/sms-composer/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ System WebView ](/docs/sdks/capacitor/system-webview/) * [ Tauri ](/docs/sdks/capacitor/tauri/) * [ Text Interaction ](/docs/sdks/capacitor/text-interaction/) * [ Text Zoom ](/docs/sdks/capacitor/text-zoom/) * [ Thermal State ](/docs/sdks/capacitor/thermal-state/) * [ Toast ](/docs/sdks/capacitor/toast/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Volume ](/docs/sdks/capacitor/volume/) * [ Wallet ](/docs/sdks/capacitor/wallet/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ YouTube Player ](/docs/sdks/capacitor/youtube-player/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm, Yarn, or bun ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories * [ Configuration ](#configuration) * [ Usage ](#usage) * [ API ](#api) * [ Type Aliases ](#type-aliases) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) # Capacitor SIM Plugin[ΒΆ](#capacitor-sim-plugin "Permanent link") Capacitor plugin for reading SIM card and carrier information. [ ![Deliver Live Updates to your Capacitor app with Capawesome Cloud](../../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://cloud.capawesome.io/) ## Features[ΒΆ](#features "Permanent link") * πŸ“‡ **SIM cards**: Read information about the SIM cards installed on the device. * πŸ”€ **Multi-SIM**: Supports devices with multiple SIM slots. * 🌐 **Carrier details**: Read carrier name, country code, MCC and MNC. * πŸ”’ **Permissions**: Built-in handling of the required runtime permission. * πŸ” **Up-to-date**: Always supports the latest Capacitor version. Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look! ## Use Cases[ΒΆ](#use-cases "Permanent link") The SIM plugin is typically used when an app needs to know about the device's SIM cards or carrier, for example: * **Carrier-specific features**: Enable or disable functionality depending on the carrier name or the MCC and MNC of the SIM card. * **Country detection**: Use the SIM card's ISO country code to preselect a country or region in your app. * **Multi-SIM handling**: Show which SIM slots are in use on devices with multiple SIM slots. * **eSIM detection**: Detect whether a SIM card is an embedded SIM (eSIM). ## Compatibility[ΒΆ](#compatibility "Permanent link") | Plugin Version | Capacitor Version | Status | | -------------- | ----------------- | -------------- | | 0.x.x | \>=8.x.x | Active support | ## Installation[ΒΆ](#installation "Permanent link") You can use our **AI-Assisted Setup** to install the plugin. Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command: `[](#%5F%5Fcodelineno-0-1)npx skills add capawesome-team/skills --skill capacitor-plugins ` Then use the following prompt: `` [](#%5F%5Fcodelineno-1-1) Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-sim` plugin in my project. `` If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below: `[](#%5F%5Fcodelineno-2-1)npm install @capawesome/capacitor-sim [](#%5F%5Fcodelineno-2-2)npx cap sync ` This plugin is only available on **Android**. On iOS and Web, all methods reject as unimplemented (see [iOS](#ios) below). ### Android[ΒΆ](#android "Permanent link") The `READ_PHONE_STATE` permission is declared in the plugin's `AndroidManifest.xml` and is merged into your app automatically. You must request it at runtime via the `requestPermissions(...)` method before calling `getSimCards(...)`. ### iOS[ΒΆ](#ios "Permanent link") Reading SIM card and carrier information is **not supported** on iOS. Apple deprecated the `CTCarrier` APIs of the Core Telephony framework with iOS 16, and they return placeholder values (e.g. `"--"` and `65535`) on iOS 16.4 and later. Because there is no reliable system API left, all methods reject as unimplemented on iOS. ## Configuration[ΒΆ](#configuration "Permanent link") No configuration required for this plugin. ## Usage[ΒΆ](#usage "Permanent link") The following examples show how to check and request permissions and read the SIM cards installed on the device. ### Check and request permissions[ΒΆ](#check-and-request-permissions "Permanent link") Reading the SIM cards requires the `READ_PHONE_STATE` runtime permission on Android. Check the current permission state and request the permission before calling `getSimCards(...)`. Only available on Android: `[](#%5F%5Fcodelineno-3-1)import { Sim } from '@capawesome/capacitor-sim'; [](#%5F%5Fcodelineno-3-2) [](#%5F%5Fcodelineno-3-3)const checkPermissions = async () => { [](#%5F%5Fcodelineno-3-4) const { readSimCards } = await Sim.checkPermissions(); [](#%5F%5Fcodelineno-3-5) return readSimCards; [](#%5F%5Fcodelineno-3-6)}; [](#%5F%5Fcodelineno-3-7) [](#%5F%5Fcodelineno-3-8)const requestPermissions = async () => { [](#%5F%5Fcodelineno-3-9) const { readSimCards } = await Sim.requestPermissions(); [](#%5F%5Fcodelineno-3-10) return readSimCards; [](#%5F%5Fcodelineno-3-11)}; ` ### Read the SIM cards[ΒΆ](#read-the-sim-cards "Permanent link") Get information about the SIM cards installed on the device, such as the carrier name, country code, MCC and MNC. On devices with multiple SIM slots, all active SIM cards are returned. Only available on Android: `[](#%5F%5Fcodelineno-4-1)import { Sim } from '@capawesome/capacitor-sim'; [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)const getSimCards = async () => { [](#%5F%5Fcodelineno-4-4) const { simCards } = await Sim.getSimCards(); [](#%5F%5Fcodelineno-4-5) return simCards; [](#%5F%5Fcodelineno-4-6)}; ` ## API[ΒΆ](#api "Permanent link") * [checkPermissions()](#checkpermissions) * [getSimCards()](#getsimcards) * [requestPermissions()](#requestpermissions) * [Interfaces](#interfaces) * [Type Aliases](#type-aliases) ### checkPermissions()[ΒΆ](#checkpermissions "Permanent link") `[](#%5F%5Fcodelineno-5-1)checkPermissions() => Promise ` Check the permission to read the SIM cards. Only available on Android. **Returns:** `Promise<[PermissionStatus](#permissionstatus)>` **Since:** 0.1.0 --- ### getSimCards()[ΒΆ](#getsimcards "Permanent link") `[](#%5F%5Fcodelineno-6-1)getSimCards() => Promise ` Get information about the SIM cards installed on the device. On devices with multiple SIM slots, all active SIM cards are returned. Only available on Android. **Returns:** `Promise<[GetSimCardsResult](#getsimcardsresult)>` **Since:** 0.1.0 --- ### requestPermissions()[ΒΆ](#requestpermissions "Permanent link") `[](#%5F%5Fcodelineno-7-1)requestPermissions() => Promise ` Request the permission to read the SIM cards. Only available on Android. **Returns:** `Promise<[PermissionStatus](#permissionstatus)>` **Since:** 0.1.0 --- ### Interfaces[ΒΆ](#interfaces "Permanent link") #### PermissionStatus[ΒΆ](#permissionstatus "Permanent link") | Prop | Type | Description | Since | | ---------------- | ----------------------------------- | ---------------------------------------------- | ----- | | **readSimCards** | [PermissionState](#permissionstate) | The permission state of reading the SIM cards. | 0.1.0 | #### GetSimCardsResult[ΒΆ](#getsimcardsresult "Permanent link") | Prop | Type | Description | Since | | ------------ | ----------- | -------------------------------------- | ----- | | **simCards** | SimCard\[\] | The SIM cards installed on the device. | 0.1.0 | #### SimCard[ΒΆ](#simcard "Permanent link") | Prop | Type | Description | Since | | --------------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | **carrierName** | string \| null | The name of the carrier. Returns null if the carrier name is not available. | 0.1.0 | | **displayName** | string \| null | The user-editable display name of the SIM card. Returns null if the display name is not available. | 0.1.0 | | **isEmbedded** | boolean \| null | Whether the SIM card is an embedded SIM (eSIM). Returns null if the information is not available. | 0.1.0 | | **isoCountryCode** | string \| null | The two-letter ISO 3166-1 country code of the carrier. Returns null if the country code is not available. | 0.1.0 | | **mobileCountryCode** | string \| null | The Mobile Country Code (MCC) of the carrier. Returns null if the mobile country code is not available. | 0.1.0 | | **mobileNetworkCode** | string \| null | The Mobile Network Code (MNC) of the carrier. Returns null if the mobile network code is not available. | 0.1.0 | | **phoneNumber** | string \| null | The phone number associated with the SIM card. This value is often empty because carriers do not reliably store the phone number on the SIM card. In that case, null is returned. | 0.1.0 | | **slotIndex** | number | The index of the SIM slot on the device. | 0.1.0 | ### Type Aliases[ΒΆ](#type-aliases "Permanent link") #### PermissionState[ΒΆ](#permissionstate "Permanent link") `'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'` ## FAQ[ΒΆ](#faq "Permanent link") ### How is this plugin different from other similar plugins?[ΒΆ](#how-is-this-plugin-different-from-other-similar-plugins "Permanent link") It reads the full picture of the device's SIM cards in a single call β€” carrier name, ISO country code, MCC and MNC, eSIM status, and the slot index for every active card on multi-SIM devices β€” through a fully typed API that handles the required Android runtime permission for you. It's honest about platform reality, too: SIM data is well supported on Android, while iOS no longer exposes it reliably, so the plugin focuses where the information is actually available. If you only need a rough country hint, a lighter approach may be enough; if you need dependable multi-SIM and carrier details, this plugin is built for exactly that. ### Why is the SIM plugin not available on iOS?[ΒΆ](#why-is-the-sim-plugin-not-available-on-ios "Permanent link") Apple deprecated the `CTCarrier` APIs of the Core Telephony framework with iOS 16, and they return placeholder values (e.g. `"--"` and `65535`) on iOS 16.4 and later. Because there is no reliable system API left for reading SIM card and carrier information, all methods reject as unimplemented on iOS. See the [iOS installation notes](#ios) for details. ### Which permissions are required to read the SIM cards?[ΒΆ](#which-permissions-are-required-to-read-the-sim-cards "Permanent link") The plugin requires the `READ_PHONE_STATE` permission on Android. It is declared in the plugin's `AndroidManifest.xml` and merged into your app automatically, so no manual manifest changes are needed. However, you must request the permission at runtime via the `requestPermissions` method before calling `getSimCards`. ### Why is the phone number `null`?[ΒΆ](#why-is-the-phone-number-null "Permanent link") The `phoneNumber` property is often empty because carriers do not reliably store the phone number on the SIM card. In that case, the plugin returns `null`. Other properties such as `carrierName` or `isoCountryCode` may also be `null` if the information is not available. ### Does the plugin support dual-SIM devices?[ΒΆ](#does-the-plugin-support-dual-sim-devices "Permanent link") Yes, on devices with multiple SIM slots, the `getSimCards` method returns all active SIM cards. Each SIM card includes a `slotIndex` property that indicates the index of the SIM slot on the device. ### Can I detect whether a SIM card is an eSIM?[ΒΆ](#can-i-detect-whether-a-sim-card-is-an-esim "Permanent link") Yes, each SIM card includes an `isEmbedded` property that indicates whether it is an embedded SIM (eSIM). The property returns `null` if the information is not available. ### Can I use this plugin with Ionic, React, Vue or Angular?[ΒΆ](#can-i-use-this-plugin-with-ionic-react-vue-or-angular "Permanent link") Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects. ## Related Plugins[ΒΆ](#related-plugins "Permanent link") * [Device Info](https://capawesome.io/docs/sdks/capacitor/device-info/): Read device information, such as the model, manufacturer, and operating system. * [Network](https://capawesome.io/docs/sdks/capacitor/network/): Access network information. * [Phone Dialer](https://capawesome.io/docs/sdks/capacitor/phone-dialer/): Open the native phone dialer prefilled with a phone number. ## Newsletter[ΒΆ](#newsletter "Permanent link") Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/). ## Changelog[ΒΆ](#changelog "Permanent link") See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/sim/CHANGELOG.md). ## License[ΒΆ](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/sim/LICENSE). July 8, 2026 Back to top ```json {"@context": "https://schema.org", "@graph": [{"@type": "TechArticle", "@id": "https://capawesome.io/docs/sdks/capacitor/sim/#article", "headline": "Capacitor SIM Plugin for Android", "name": "Capacitor SIM Plugin for Android", "description": "Capacitor plugin to read SIM card and carrier information such as carrier name, country code, MCC, and MNC on Android.", "inLanguage": "en", "url": "https://capawesome.io/docs/sdks/capacitor/sim/", "mainEntityOfPage": "https://capawesome.io/docs/sdks/capacitor/sim/", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "about": {"@id": "https://capawesome.io/docs/sdks/capacitor/sim/#software"}}, {"@type": "SoftwareSourceCode", "@id": "https://capawesome.io/docs/sdks/capacitor/sim/#software", "name": "Capacitor SIM Plugin for Android", "description": "Capacitor plugin to read SIM card and carrier information such as carrier name, country code, MCC, and MNC on Android.", "url": "https://capawesome.io/docs/sdks/capacitor/sim/", "programmingLanguage": "TypeScript", "runtimePlatform": "Capacitor", "codeRepository": "https://github.com/capawesome-team", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}}]} {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "How is this plugin different from other similar plugins?", "acceptedAnswer": {"@type": "Answer", "text": "It reads the full picture of the device's SIM cards in a single call β€” carrier name, ISO country code, MCC and MNC, eSIM status, and the slot index for every active card on multi-SIM devices β€” through a fully typed API that handles the required Android runtime permission for you. It's honest about platform reality, too: SIM data is well supported on Android, while iOS no longer exposes it reliably, so the plugin focuses where the information is actually available. If you only need a rough country hint, a lighter approach may be enough; if you need dependable multi-SIM and carrier details, this plugin is built for exactly that."}}, {"@type": "Question", "name": "Why is the SIM plugin not available on iOS?", "acceptedAnswer": {"@type": "Answer", "text": "Apple deprecated the CTCarrier APIs of the Core Telephony framework with iOS 16, and they return placeholder values (e.g. \"--\" and 65535) on iOS 16.4 and later. Because there is no reliable system API left for reading SIM card and carrier information, all methods reject as unimplemented on iOS. See the iOS installation notes for details."}}, {"@type": "Question", "name": "Which permissions are required to read the SIM cards?", "acceptedAnswer": {"@type": "Answer", "text": "The plugin requires the READ_PHONE_STATE permission on Android. It is declared in the plugin's AndroidManifest.xml and merged into your app automatically, so no manual manifest changes are needed. However, you must request the permission at runtime via the requestPermissions method before calling getSimCards."}}, {"@type": "Question", "name": "Why is the phone number null?", "acceptedAnswer": {"@type": "Answer", "text": "The phoneNumber property is often empty because carriers do not reliably store the phone number on the SIM card. In that case, the plugin returns null. Other properties such as carrierName or isoCountryCode may also be null if the information is not available."}}, {"@type": "Question", "name": "Does the plugin support dual-SIM devices?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, on devices with multiple SIM slots, the getSimCards method returns all active SIM cards. Each SIM card includes a slotIndex property that indicates the index of the SIM slot on the device."}}, {"@type": "Question", "name": "Can I detect whether a SIM card is an eSIM?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, each SIM card includes an isEmbedded property that indicates whether it is an embedded SIM (eSIM). The property returns null if the information is not available."}}, {"@type": "Question", "name": "Can I use this plugin with Ionic, React, Vue or Angular?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects."}}], "url": "https://capawesome.io/docs/sdks/capacitor/sim/"} ```