List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).
GET
/
api
/
esim
/
my-esims
My eSIMs
curl --request GET \ --url https://bilalsadasub.com/api/esim/my-esims \ --header 'Authorization: <api-key>'
Lists the eSIMs on your account (latest 50) with activation details and live data usage.
Status fields
status — success, processing or failed.
esim_status — the provider lifecycle, e.g. GOT_RESOURCE (ready to install), IN_USE, USED_UP, EXPIRED.
data_total_gb / data_used_gb / data_remaining_gb — usage in GB (may be null until the provider reports it).
expired_at / purchased_at — ISO 8601 timestamps.
Pass refresh=true to pull fresh status and usage from the provider for your active eSIMs (up to 10 per call). Without it, the stored values are returned instantly.
Authorizations
Authorization
string
header
required
Send your API key as Token <your_api_key>.
Use your live key for real transactions, or your sandbox key (sk_test_…) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add "sandbox_status": "fail" to any sandbox request to simulate a failure.
Query Parameters
refresh
boolean
Set true to re-sync live status/usage from the provider
Response
200 - application/json
Success
status
string
data
object[]
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bilalsadasub","description":"Bilalsadasub developer API — buy data, airtime, cable, electricity, bulk SMS, exam pins, airtime-to-cash and flights, funded from your wallet.","colors":{"primary":"#1D4ED8","light":"#3B82F6","dark":"#1E3A8A"},"logo":{"light":"https://bilalsadasub.com/brand_lockup.webp","dark":"https://bilalsadasub.com/brand_lockup.webp"},"favicon":"https://bilalsadasub.com/logo_icon.png","api":{"openapi":"https://bilalsadasub.com/openapi.json","playground":{"display":"interactive"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.bilalsadasub.com"}},"footer":{"socials":{"website":"https://bilalsadasub.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bilalsadasub-com","hasAudioNarration":false,"actualSubdomain":"bilalsadasub-com","customDomains":["docs.bilalsadasub.com"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-ade-2121daa2-25fd5941","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ada85aa3650fcdd2dd1d391","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"API Reference","count":37},{"language":"default","tag":"Flights","count":9},{"language":"default","tag":"Purchases","count":8},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Catalogs","count":4},{"language":"default","tag":"eSIM","count":4},{"language":"default","tag":"Smile / Alpha / Kirani","count":4},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Resources","count":3},{"language":"default","tag":"Recharge \u0026 Data Cards","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"reference/esim-my","slug":"/reference/esim-my","pageMetadata":{"title":"My eSIMs","openapi":"GET /api/esim/my-esims","description":"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).","href":"/reference/esim-my"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Lists the eSIMs on your account (latest 50) with activation details and live data usage.`}),`\n`,_jsx(Heading,{level:`2`,id:`status-fields`,children:`Status fields`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`status`})}),` — `,_jsx(_components.code,{children:`success`}),`, `,_jsx(_components.code,{children:`processing`}),` or `,_jsx(_components.code,{children:`failed`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`esim_status`})}),` — the provider lifecycle, e.g. `,_jsx(_components.code,{children:`GOT_RESOURCE`}),` (ready to install), `,_jsx(_components.code,{children:`IN_USE`}),`, `,_jsx(_components.code,{children:`USED_UP`}),`, `,_jsx(_components.code,{children:`EXPIRED`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`data_total_gb`}),` / `,_jsx(_components.code,{children:`data_used_gb`}),` / `,_jsx(_components.code,{children:`data_remaining_gb`})]}),` — usage in GB (may be `,_jsx(_components.code,{children:`null`}),` until the provider reports it).`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`expired_at`}),` / `,_jsx(_components.code,{children:`purchased_at`})]}),` — ISO 8601 timestamps.`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Pass `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`refresh=true`})}),` to pull fresh status and usage from the provider for your active eSIMs (up to 10 per call). Without it, the stored values are returned instantly.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"My eSIMs","openapi":"GET /api/esim/my-esims","description":"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).","href":"/reference/esim-my"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Status fields","slug":"status-fields","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"My eSIMs","tags":["eSIM"],"description":"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).","parameters":["9cc56e9b-710a-4ec6-bc8b-a633f35c1900"],"responses":{"200":"5ef348cc-ebc2-42dd-94f1-6155a72c4e6a"},"method":"get","type":"path","servers":["3dadd86c-1cfa-4bb6-91ab-b7863ea294dd"],"security":["78ecb7a6-a02e-4043-9444-ae47de4933eb"],"path":"/api/esim/my-esims","baseUrlOptions":["https://bilalsadasub.com"],"title":"My eSIMs","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9cc56e9b-710a-4ec6-bc8b-a633f35c1900":{"name":"refresh","in":"query","required":false,"description":"Set true to re-sync live status/usage from the provider","schema":{"type":"boolean","isRequired":false,"description":"Set true to re-sync live status/usage from the provider","uniqueKey":"","typeLabel":"boolean"}}},"responses":{"5ef348cc-ebc2-42dd-94f1-6155a72c4e6a":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","uniqueKey":"status","typeLabel":"string"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"Your eSIM ID (pass as esim_id to Top up eSIM)","uniqueKey":"data.items.[INDEX].id","typeLabel":"integer"},"package_name":{"type":"string","description":"Plan name","uniqueKey":"data.items.[INDEX].package_name","typeLabel":"string"},"iccid":{"type":"string","description":"eSIM ICCID","uniqueKey":"data.items.[INDEX].iccid","typeLabel":"string"},"ac":{"type":"string","description":"Activation code / LPA string","uniqueKey":"data.items.[INDEX].ac","typeLabel":"string"},"qr_code":{"type":"string","description":"QR code image URL","uniqueKey":"data.items.[INDEX].qr_code","typeLabel":"string"},"amount_paid":{"type":"number","description":"Amount paid in NGN","uniqueKey":"data.items.[INDEX].amount_paid","typeLabel":"number"},"status":{"type":"string","description":"success | failed | processing","uniqueKey":"data.items.[INDEX].status","typeLabel":"string"},"esim_status":{"type":"string","description":"Provider lifecycle status, e.g. GOT_RESOURCE, IN_USE","uniqueKey":"data.items.[INDEX].esim_status","typeLabel":"string"},"data_total_gb":{"type":"number","description":"Total data in GB (null until known)","uniqueKey":"data.items.[INDEX].data_total_gb","typeLabel":"number"},"data_used_gb":{"type":"number","description":"Data used in GB","uniqueKey":"data.items.[INDEX].data_used_gb","typeLabel":"number"},"data_remaining_gb":{"type":"number","description":"Data remaining in GB","uniqueKey":"data.items.[INDEX].data_remaining_gb","typeLabel":"number"},"expired_at":{"type":"string","description":"Expiry timestamp (ISO 8601)","uniqueKey":"data.items.[INDEX].expired_at","typeLabel":"string"},"purchased_at":{"type":"string","description":"Purchase timestamp (ISO 8601)","uniqueKey":"data.items.[INDEX].purchased_at","typeLabel":"string"},"transid":{"type":"string","description":"Transaction reference","uniqueKey":"data.items.[INDEX].transid","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"status":"success","data":[{"id":34,"package_name":"USA 5GB / 30 Days","iccid":"8910300000000123456","ac":"LPA:1$rsp.truphone.com$QR-G4-XXXX","qr_code":"https://bilalsadasub.com/storage/esim/qr/ES_1a2b3c.png","amount_paid":7200,"status":"success","esim_status":"IN_USE","data_total_gb":5,"data_used_gb":1.8,"data_remaining_gb":3.2,"expired_at":"2026-11-21T10:00:00+00:00","purchased_at":"2026-10-22T10:00:00+00:00","transid":"ES_1a2b3c"}]},"examples":{"Example":{"title":"Example","value":{"status":"success","data":[{"id":34,"package_name":"USA 5GB / 30 Days","iccid":"8910300000000123456","ac":"LPA:1$rsp.truphone.com$QR-G4-XXXX","qr_code":"https://bilalsadasub.com/storage/esim/qr/ES_1a2b3c.png","amount_paid":7200,"status":"success","esim_status":"IN_USE","data_total_gb":5,"data_used_gb":1.8,"data_remaining_gb":3.2,"expired_at":"2026-11-21T10:00:00+00:00","purchased_at":"2026-10-22T10:00:00+00:00","transid":"ES_1a2b3c"}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"78ecb7a6-a02e-4043-9444-ae47de4933eb":{"TokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Send your API key as `Token \u003cyour_api_key>`.\n\nUse your **live key** for real transactions, or your **sandbox key** (`sk_test_…`) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add `\"sandbox_status\": \"fail\"` to any sandbox request to simulate a failure.","scopes":[],"schemeName":"TokenAuth"}}},"servers":{"3dadd86c-1cfa-4bb6-91ab-b7863ea294dd":{"url":"https://bilalsadasub.com","description":"Production (live — charges your wallet)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Send your API key as `Token \u003cyour_api_key>`.\n\nUse your **live key** for real transactions, or your **sandbox key** (`sk_test_…`) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add `\"sandbox_status\": \"fail\"` to any sandbox request to simulate a failure.","scopes":[],"schemeName":"TokenAuth"},"schema":{"title":"Authorization","type":"string","description":"Send your API key as `Token \u003cyour_api_key>`.\n\nUse your **live key** for real transactions, or your **sandbox key** (`sk_test_…`) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add `\"sandbox_status\": \"fail\"` to any sandbox request to simulate a failure.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"TokenAuth","name":"Authorization"}],"title":"TokenAuth"}]},"originalFileLocation":"https://bilalsadasub.com/openapi.json"},"subdomain":"bilalsadasub-com","siteName":"Bilalsadasub","title":"My eSIMs - Bilalsadasub","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T21:27:18.456Z","originalFileLocation":"reference/esim-my.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bilalsadasub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://bilalsadasub.com/logo_icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://bilalsadasub.com/logo_icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://bilalsadasub.com/logo_icon.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://bilalsadasub.com/logo_icon.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"My eSIMs - Bilalsadasub\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bilalsadasub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bilalsadasub.com/reference/esim-my\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bilalsadasub-com.mintlify.site/_mintlify/api/og/v2?division=eSIM\u0026amp;title=My+eSIMs\u0026amp;description=List+the+eSIMs+on+your+account+%28latest+50%29+with+activation+details+and+data+usage.+Pass+refresh%3Dtrue+to+re-sync+live+status%2Fusage+from+the+provider+%28up+to+10+ac\u0026amp;theme=8b20832f109be403953f6a8c\u0026amp;signature=4035368103ac8c04fe417f6ea3457d19314f35ad75c8c29a487404dcbe422f3c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"My eSIMs - Bilalsadasub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bilalsadasub-com.mintlify.site/_mintlify/api/og/v2?division=eSIM\u0026amp;title=My+eSIMs\u0026amp;description=List+the+eSIMs+on+your+account+%28latest+50%29+with+activation+details+and+data+usage.+Pass+refresh%3Dtrue+to+re-sync+live+status%2Fusage+from+the+provider+%28up+to+10+ac\u0026amp;theme=8b20832f109be403953f6a8c\u0026amp;signature=4035368103ac8c04fe417f6ea3457d19314f35ad75c8c29a487404dcbe422f3c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/bilalsadasub-com/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bilalsadasub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1D4ED8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bilalsadasub.com/reference/esim-my\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/esim-my.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bilalsadasub.com/#organization\",\"name\":\"Bilalsadasub\",\"url\":\"https://docs.bilalsadasub.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://bilalsadasub.com/brand_lockup.webp\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bilalsadasub.com#website\",\"name\":\"Bilalsadasub\",\"url\":\"https://docs.bilalsadasub.com\",\"publisher\":{\"@id\":\"https://docs.bilalsadasub.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bilalsadasub.com/reference/esim-my#webpage\",\"url\":\"https://docs.bilalsadasub.com/reference/esim-my\",\"name\":\"My eSIMs\",\"description\":\"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).\",\"dateModified\":\"2026-10-22T21:27:18.456Z\",\"isPartOf\":{\"@id\":\"https://docs.bilalsadasub.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bilalsadasub.com/reference/esim-my#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bilalsadasub.com/reference/esim-my#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"eSIM\",\"item\":\"https://docs.bilalsadasub.com/reference/esim-plans\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"My eSIMs\",\"item\":\"https://docs.bilalsadasub.com/reference/esim-my\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bilalsadasub.com/reference/esim-my#apireference\",\"headline\":\"My eSIMs\",\"name\":\"My eSIMs\",\"description\":\"List the eSIMs on your account (latest 50) with activation details and data usage. Pass refresh=true to re-sync live status/usage from the provider (up to 10 active eSIMs per call).\",\"url\":\"https://docs.bilalsadasub.com/reference/esim-my\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bilalsadasub.com/reference/esim-my#webpage\"},\"dateModified\":\"2026-10-22T21:27:18.456Z\",\"publisher\":{\"@id\":\"https://docs.bilalsadasub.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bilalsadasub.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bilalsadasub\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bilalsadasub\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/esim-my.md","siteName":"Bilalsadasub","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Authentication","pages":[{"title":"Generate Access Token","openapi":"POST /api/user","href":"/reference/generate-token"}]},{"group":"Purchases","pages":[{"title":"Buy Data","openapi":"POST /api/data","href":"/reference/data"},{"title":"Buy Airtime","openapi":"POST /api/topup","href":"/reference/airtime"},{"title":"Cable Subscription","openapi":"POST /api/cable","href":"/reference/cable"},{"title":"Pay Electricity Bill","openapi":"POST /api/bill","href":"/reference/electricity"},{"title":"Send Bulk SMS","openapi":"POST /api/bulksms","href":"/reference/bulksms"},{"title":"Buy Exam Pins","openapi":"POST /api/exam","href":"/reference/exam"},{"title":"Requery Transaction","openapi":"GET /api/requery/{reference}","href":"/reference/requery"},{"title":"List Transactions","openapi":"GET /api/v1/transactions","href":"/reference/transactions"}]},{"group":"Verification","pages":[{"title":"Verify Smartcard","openapi":"GET /api/cable/cable-validation","href":"/reference/verify-smartcard"},{"title":"Verify Meter","openapi":"GET /api/bill/bill-validation","href":"/reference/verify-meter"}]},{"group":"Catalogs","pages":[{"title":"List Data Plans","openapi":"GET /api/v1/plans/data","href":"/reference/data-plans"},{"title":"List Networks","openapi":"GET /api/v1/plans/networks","href":"/reference/networks"},{"title":"List Cable Plans","openapi":"GET /api/v1/plans/cable","href":"/reference/cable-plans"},{"title":"List DISCOs","openapi":"GET /api/v1/plans/discos","href":"/reference/discos"}]},{"group":"Wallet","pages":[{"title":"Airtime to Cash","openapi":"POST /api/cash","href":"/reference/airtime-to-cash"}]},{"group":"eSIM","pages":[{"title":"List eSIM Plans","openapi":"GET /api/esim/plans","href":"/reference/esim-plans"},{"title":"Buy eSIM","openapi":"POST /api/esim/buy","href":"/reference/esim-buy"},{"title":"Top up eSIM","openapi":"POST /api/esim/topup","description":"Add another data plan to an eSIM you already own. Only plans where topup_supported is true can be used. Wallet is debited; a failed top-up auto-refunds.","href":"/reference/esim-topup"},{"title":"My eSIMs","openapi":"GET /api/esim/my-esims","href":"/reference/esim-my"}]},{"group":"Smile / Alpha / Kirani","pages":[{"title":"List SAK Plans","openapi":"GET /api/sak/plans","description":"List Smile, Alpha and Kirani bundle plans with prices and plan IDs.","href":"/reference/sak-plans"},{"title":"Buy SAK Bundle","openapi":"POST /api/sak","href":"/reference/sak-buy"},{"title":"List SAK Numbers","openapi":"GET /api/sak/sim","href":"/reference/sak-sim"},{"title":"Buy SAK Numbers","openapi":"POST /api/sak/sim/buy","href":"/reference/sak-sim-buy"}]},{"group":"Flights","pages":[{"title":"Search Flights","openapi":"GET /api/flight/search","href":"/reference/flight-search"},{"title":"Search Airports","openapi":"GET /api/flight/airports","href":"/reference/flight-airports"},{"title":"List Airlines","openapi":"GET /api/flight/airlines","href":"/reference/flight-airlines"},{"title":"Add-on Pricing","openapi":"GET /api/flight/addons","href":"/reference/flight-addons"},{"title":"Book Flight","openapi":"POST /api/flight/book","href":"/reference/flight-book"},{"title":"My Flight Bookings","openapi":"GET /api/flight/bookings","href":"/reference/flight-bookings"},{"title":"Get Flight Booking","openapi":"GET /api/flight/booking/{reference}","href":"/reference/flight-booking"},{"title":"Download Ticket","openapi":"GET /api/flight/booking/{reference}/ticket","href":"/reference/flight-ticket"},{"title":"Cancel Flight Booking","openapi":"POST /api/flight/booking/{reference}/cancel","href":"/reference/flight-cancel"}]},{"group":"Gift Cards","pages":[{"title":"List Gift Cards","openapi":"GET /api/giftcard/plans","href":"/reference/giftcard-plans"},{"title":"Buy Gift Card","openapi":"POST /api/giftcard/buy","href":"/reference/giftcard-buy"}]},{"group":"Recharge \u0026 Data Cards","pages":[{"title":"Buy Data Card","openapi":"POST /api/data_card","href":"/reference/data-card"},{"title":"Buy Recharge Card","openapi":"POST /api/recharge_card","href":"/reference/recharge-card"}]}]}]},"basePath":"","title":"My eSIMs - Bilalsadasub","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-_HcdDqS2.js","snippetPresets-CXnm-WO6.js","utils-Dg59J__o.js","style-to-object-BY3JEAdk.js","utils-D8TRpdk7.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-B6QaxWc5.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DeMZ-lcM.js","_Uint8Array-BjA2mcVW.js","isObject-FP1Yky1u.js","ApiExamples-cjPyMv63.js","usePlaygroundInputsStore-D7BWoaw4.js","shallow-Z1ceDNSG.js","isEqual-BObTuQrO.js","CodeSnippets-D1UZ1AE-.js","CodeSnippet-B373COAT.js","getApiPlaygroundDisplay-CfL-UuDS.js","Page-DuqezyvM.js","DynamicMarkdown-5yMTCLas.js","SectionHeading-BxT1HYfP.js","icon-DYJTTD3g.js","MethodPill-4AyycJeu.js","getPastedJson-Bp3WV6cN.js","Check2Icon-PhZu6Gry.js","axios-CsQoIw0U.js","Markdown-Dy9a8hT8.js","AssistantPageLink-87tSPwGm.js","dist-CXMB3QQU.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}