Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.
Everything your account may start, one entry per choice: the saved Android phone, the temporary Android phone, and your own devices once we have set them up. Which one to start is your choice; the service keeps no preference.
What a start that names nothing gets: a temporary Android emulator. The endpoint's rule, not a preference.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"phone-harness","description":"Start a temporary Android phone, install your app, and automate it through the Phone Harness API.","colors":{"primary":"#20231E","light":"#E5E9DF","dark":"#20231E"},"logo":{"light":"https://mintcdn.com/phone-harness/k6Ti82e3lkhdZ8Co/images/wordmark-light.svg?fit=max\u0026auto=format\u0026n=k6Ti82e3lkhdZ8Co\u0026q=85\u0026s=f1a15d5a898e668d2c240f632b5842a5","dark":"https://mintcdn.com/phone-harness/k6Ti82e3lkhdZ8Co/images/wordmark-dark.svg?fit=max\u0026auto=format\u0026n=k6Ti82e3lkhdZ8Co\u0026q=85\u0026s=0cf12755a0e27be7f6002c73ec09db89","href":"https://phone-harness.com/docs"},"favicon":"https://mintcdn.com/phone-harness/k6Ti82e3lkhdZ8Co/images/favicon.svg?fit=max\u0026auto=format\u0026n=k6Ti82e3lkhdZ8Co\u0026q=85\u0026s=bde1fb20f9d05f502adc0283f6b5fb87","api":{"playground":{"display":"interactive","proxy":false},"examples":{"defaults":"required","languages":["bash","python","javascript"],"prefill":false},"url":"full"},"appearance":{"default":"light"},"background":{"color":{"light":"#F6F7F1","dark":"#191C19"}},"navbar":{"links":[{"href":"mailto:support@phone-harness.com","label":"Support"}],"primary":{"type":"button","label":"Open dashboard","href":"https://phone-harness.com/dashboard"}},"footer":{"socials":{"github":"https://github.com/phone-harness"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"phone-harness","hasAudioNarration":false,"actualSubdomain":"phone-harness","customDomains":["phone-harness.com"],"gitSource":{"type":"github","owner":"phone-harness","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae85ae8a8708698b47aea78","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Endpoints","count":20},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Account","count":5},{"language":"default","tag":"Sessions","count":5},{"language":"default","tag":"ADB","count":4},{"language":"default","tag":"Viewer","count":3},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"History","count":2},{"language":"default","tag":"Use cases","count":1},{"language":"default","tag":"Service","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--ph-bg: #f6f7f1;--ph-fg: #20231e;--ph-muted: #72766d;--ph-line: #c7cbc0;--ph-soft: #eceee6;--ph-sans: Arial, Helvetica, sans-serif;--ph-mono: \"SFMono-Regular\", Consolas, \"Liberation Mono\", monospace;--font-inter: var(--ph-sans) !important;--font-jetbrains-mono: var(--ph-mono) !important;--gray-50: 246 247 241;--gray-100: 236 238 230;--gray-200: 229 233 223;--gray-300: 199 203 192;--gray-400: 157 165 152;--gray-500: 114 118 109;--gray-600: 94 100 88;--gray-700: 66 72 62;--gray-800: 37 42 36;--gray-900: 32 35 30;--gray-950: 25 28 25}:root.dark{--ph-bg: #191c19;--ph-fg: #e5e9df;--ph-muted: #9da598;--ph-line: #42483e;--ph-soft: #252a24}html,body{background:var(--ph-bg);color:var(--ph-fg);font-family:var(--ph-sans)!important}h1,h2,h3,h4,h5,h6,button,input,select,textarea{font-family:var(--ph-sans)!important}pre,code,kbd,.font-mono,[data-component-part=\"field-name\"],[data-component-part=\"code-group-tab-content\"]{font-family:var(--ph-mono)!important}#navbar-transition{background:var(--ph-bg)!important;border-bottom:1px solid var(--ph-line);backdrop-filter:none}#navbar .nav-logo{width:224px;height:32px;max-width:100%}#page-title{font-size:26px;font-weight:500;line-height:1.25;letter-spacing:-0.7px;color:var(--ph-fg)}#content-area h2{font-size:20px;font-weight:500;letter-spacing:-0.25px;color:var(--ph-fg)}#content-area h3{font-size:17px;font-weight:500;color:var(--ph-fg)}.prose{--tw-prose-body: var(--ph-fg) !important;--tw-prose-headings: var(--ph-fg) !important;--tw-prose-links: var(--ph-fg) !important;--tw-prose-bold: var(--ph-fg) !important;--tw-prose-code: var(--ph-fg) !important;--tw-prose-counters: var(--ph-muted);--tw-prose-bullets: var(--ph-muted);--tw-prose-hr: var(--ph-line);--tw-prose-th-borders: var(--ph-line);--tw-prose-td-borders: var(--ph-line);font-size:15px;line-height:1.7}#header>.prose{color:var(--ph-muted);font-size:15px}#sidebar-content{font-size:13px}#sidebar-title,#sidebar-content h5{font-family:var(--ph-mono)!important;font-size:10px;font-weight:400;letter-spacing:0.9px;text-transform:uppercase;color:var(--ph-muted)}#sidebar-content a,#sidebar-content button{border-radius:0}#sidebar-content a[aria-current=\"page\"]{background:var(--ph-soft);color:var(--ph-fg);box-shadow:inset 2px 0 var(--ph-fg)}#search-bar-entry{border:1px solid var(--ph-line);border-radius:0;background:transparent;color:var(--ph-muted);box-shadow:none;filter:none;font-size:13px}#search-bar-entry:hover{border-color:var(--ph-fg);background:var(--ph-soft);filter:none}#mobile-nav-content,[id^=\"headlessui-dialog-panel\"]{background:var(--ph-bg)!important;border:1px solid var(--ph-line);border-radius:0}#topbar-cta-button a{min-height:32px;border:1px solid var(--ph-fg);border-radius:0;background:var(--ph-fg);color:var(--ph-bg);font-size:12px}#topbar-cta-button a>span{display:none}#topbar-cta-button a :is(span,svg){color:var(--ph-bg)}#topbar-cta-button a:hover{background:var(--ph-soft)}#topbar-cta-button a:hover :is(span,svg){color:var(--ph-fg)}.code-group,.code-block,.callout,.card,#page-context-menu,#page-context-menu-button,#page-context-menu button,#request-example,#response-example,[data-component-part=\"code-block-root\"],[data-component-part=\"code-group-tab-bar\"],#api-playground-input input,#api-playground-input select,#api-playground-input textarea{border-radius:0!important}.code-group,.code-block,.card,[data-component-part=\"code-group-tab-bar\"]{border-color:var(--ph-line)!important}.code-block-background,[data-component-part=\"code-block-root\"],[data-component-part=\"code-group-tab-bar\"]{--shiki-dark-bg: var(--ph-soft) !important;background-color:var(--ph-soft)!important}:root .code-group [data-component-part=\"code-block-root\"],:root .code-block [data-component-part=\"code-block-root\"]{border-radius:0!important;background-color:var(--ph-soft)!important}.code-group,#page-context-menu button{border-color:var(--ph-line)!important}.code-group{background:var(--ph-soft)!important}.code-block [data-floating-buttons]{background:var(--ph-soft)}.code-block [data-floating-buttons]::before,.code-block [data-floating-buttons]::after{background:none}.code-block [style*=\"--fade-color-light\"]{--fade-color-light: var(--ph-soft) !important;--fade-color-dark: var(--ph-soft) !important}.code-block button,.code-group button{border-radius:0!important;backdrop-filter:none}[id^=\"api-playground-\"] :is(.border-standard,.tryit-button),[id^=\"api-playground-\"]>div{border-radius:0!important}.tryit-button{background:var(--ph-fg)!important;color:var(--ph-bg)!important}.tryit-button svg{background-color:var(--ph-bg)!important}:focus-visible{outline:2px solid var(--ph-fg);outline-offset:3px}:root .code-block-background:focus-visible{outline:2px solid var(--ph-fg)!important;outline-offset:-2px}@media (max-width: 640px){#navbar .nav-logo{width:210px;height:30px}#page-title{font-size:23px}}"}],"page":{"pagePath":"api-reference/account/get-account","slug":"/api-reference/account/get-account","pageMetadata":{"title":"Get your account","description":"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.","deprecated":null,"version":null,"sidebarTitle":"Get account","openapi":"/openapi.json get /me","href":"/api-reference/account/get-account","autogeneratedByOpenApi":true},"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: \"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get your account","description":"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.","deprecated":null,"version":null,"sidebarTitle":"Get account","openapi":"/openapi.json get /me","href":"/api-reference/account/get-account","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get your account","operationId":"get-account","tags":["Account"],"description":"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.","responses":{"200":"9c472dfc-5afc-4c3f-b8b4-4be637281376","401":"3206e067-e47e-4438-95bf-8767033e28d2","403":"a674c4c3-b9bd-4ce3-a7ab-2667c77a89e2","500":"f26003e9-dfe3-49c8-ab58-90bdd4acc7b1"},"x-mint":{"href":"/api-reference/account/get-account"},"method":"get","type":"path","servers":["bcfacf48-4e0a-46da-900c-90d25768345c"],"security":["843d9498-6aa5-48aa-8108-f009c2276f02"],"path":"/me","baseUrlOptions":["https://api.phone-harness.com"],"title":"Get your account","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true,"urlDisplay":"full"},"dependencies":{"parameters":{},"responses":{"9c472dfc-5afc-4c3f-b8b4-4be637281376":{"description":"Account.","content":{"application/json":{"schema":{"type":"object","properties":{"uid":{"type":"string","isRequired":true,"uniqueKey":"uid","typeLabel":"string"},"email":{"oneOf":[{"type":"string","format":"email","isRequired":true,"uniqueKey":"email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","isRequired":true,"uniqueKey":"email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"email","typeLabel":"string\u003cemail> | null"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"name","typeLabel":"string | null"},"created":{"type":"number","description":"Account creation. Unix time in seconds.","isRequired":true,"uniqueKey":"created","typeLabel":"number"},"balance_cents":{"type":"integer","description":"US cents of available account credit.","isRequired":true,"uniqueKey":"balance_cents","typeLabel":"integer"},"price_cents_per_minute":{"type":"integer","description":"Current metered rate in US cents per minute.","isRequired":true,"uniqueKey":"price_cents_per_minute","typeLabel":"integer"},"environment":{"type":"string","isRequired":true,"uniqueKey":"environment","typeLabel":"string"},"billing_mode":{"type":"string","enum":["metered","disabled"],"isRequired":true,"uniqueKey":"billing_mode","typeLabel":"enum\u003cstring>"},"active_session_billing_mode":{"oneOf":[{"type":"string","enum":["metered","disabled",null],"isRequired":true,"uniqueKey":"active_session_billing_mode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["metered","disabled",null],"isRequired":true,"uniqueKey":"active_session_billing_mode.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"active_session_billing_mode","typeLabel":"enum\u003cstring> | null"},"session_create_idempotency":{"type":"string","enum":["v1"],"isRequired":true,"uniqueKey":"session_create_idempotency","typeLabel":"enum\u003cstring>"},"session_limit":{"type":"integer","description":"Account limit, not a service-wide capacity guarantee.","isRequired":true,"uniqueKey":"session_limit","typeLabel":"integer"},"active_session_count":{"type":"integer","description":"Includes sessions pending cleanup.","isRequired":true,"uniqueKey":"active_session_count","typeLabel":"integer"},"available_session_slots":{"type":"integer","description":"Remaining account slots. Shared capacity is checked separately.","isRequired":true,"uniqueKey":"available_session_slots","typeLabel":"integer"},"can_rent":{"type":"boolean","description":"Access gate only; balance and capacity are checked separately at creation.","isRequired":true,"uniqueKey":"can_rent","typeLabel":"boolean"},"profile":{"type":"object","description":"Your own phone: one per account, kept between sessions.","properties":{"id":{"type":"string","description":"Pass this as profile_id when creating a session.","uniqueKey":"profile.id","typeLabel":"string"},"state":{"type":"string","enum":["empty","stored","running","saving"],"description":"empty: nothing saved yet; stored: saved and ready to resume; running: held by a live session; saving: being stored after a session ended.","uniqueKey":"profile.state","typeLabel":"enum\u003cstring>"},"session":{"oneOf":[{"type":"string","description":"The live session holding the phone, if any.","uniqueKey":"profile.session.oneOf.0","typeLabel":"string"},{"type":"null","description":"The live session holding the phone, if any.","uniqueKey":"profile.session.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.session","typeLabel":"string | null"},"exact":{"oneOf":[{"type":"boolean","description":"true when the saved phone resumes exactly as left; false when it will come back rebooted with its data intact.","uniqueKey":"profile.exact.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"true when the saved phone resumes exactly as left; false when it will come back rebooted with its data intact.","uniqueKey":"profile.exact.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.exact","typeLabel":"boolean | null"},"saved_at":{"oneOf":[{"type":"number","description":"Unix seconds of the last save.","uniqueKey":"profile.saved_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"Unix seconds of the last save.","uniqueKey":"profile.saved_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.saved_at","typeLabel":"number | null"}},"uniqueKey":"profile","typeLabel":"object"},"available":{"type":"array","description":"Everything your account may start, one entry per choice: the saved Android phone, the temporary Android phone, and your own devices once we have set them up. Which one to start is your choice; the service keeps no preference.","items":{"type":"object","properties":{"platform":{"type":"string","enum":["android","ios"],"description":"What the phone is: `android` or `ios`.","uniqueKey":"available.items.[INDEX].platform","typeLabel":"enum\u003cstring>"},"kind":{"type":"string","enum":["emulator","device"],"description":"How it runs: an `emulator`, or a real `device` (your own phone on a host).","uniqueKey":"available.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"label":{"type":"string","description":"Your own device's label, when it has one.","uniqueKey":"available.items.[INDEX].label","typeLabel":"string"},"id":{"type":"string","description":"The choice's id: for your own device, the id to start it with and to reset it, for example iph-622c376ba7.","uniqueKey":"available.items.[INDEX].id","typeLabel":"string"},"state":{"type":"string","description":"Your own device's state: `available`, `running` (one of your sessions holds it), `resetting` (being erased and set up again), `reset_failed` (its last reset did not finish; reset it again), or `unavailable` (it cannot be reached right now). The saved Android phone reports its own states: `empty`, `stored`, `running`, `saving`.","uniqueKey":"available.items.[INDEX].state","typeLabel":"string"}},"uniqueKey":"available.items.[INDEX]","typeLabel":"object"},"uniqueKey":"available","typeLabel":"object[]"},"rent_blocked_reason":{"type":"string","description":"Present if can_rent is false.","uniqueKey":"rent_blocked_reason","typeLabel":"string"},"unnamed":{"type":"object","description":"What a start that names nothing gets: a temporary Android emulator. The endpoint's rule, not a preference.","properties":{"platform":{"type":"string","enum":["android"],"uniqueKey":"unnamed.platform","typeLabel":"enum\u003cstring>"},"kind":{"type":"string","enum":["emulator"],"uniqueKey":"unnamed.kind","typeLabel":"enum\u003cstring>"},"temporary":{"type":"boolean","uniqueKey":"unnamed.temporary","typeLabel":"boolean"}},"uniqueKey":"unnamed","typeLabel":"object"}},"required":["uid","email","name","created","balance_cents","price_cents_per_minute","environment","billing_mode","active_session_billing_mode","session_create_idempotency","session_limit","active_session_count","available_session_slots","can_rent"],"uniqueKey":"","typeLabel":"object"},"example":{"uid":"exampleuser1","email":"developer@example.com","name":"Example developer","created":1800000000,"balance_cents":1000,"price_cents_per_minute":5,"environment":"production","billing_mode":"metered","active_session_billing_mode":null,"session_create_idempotency":"v1","unnamed":{"platform":"android","kind":"emulator","temporary":true},"session_limit":2,"active_session_count":0,"available_session_slots":2,"can_rent":true,"profile":{"id":"prof-3f9c2a1b7d5e4c6a8b0f1e2d","state":"stored","session":null,"exact":true,"saved_at":1800000600}},"examples":{"Example":{"title":"Example","value":{"uid":"exampleuser1","email":"developer@example.com","name":"Example developer","created":1800000000,"balance_cents":1000,"price_cents_per_minute":5,"environment":"production","billing_mode":"metered","active_session_billing_mode":null,"session_create_idempotency":"v1","unnamed":{"platform":"android","kind":"emulator","temporary":true},"session_limit":2,"active_session_count":0,"available_session_slots":2,"can_rent":true,"profile":{"id":"prof-3f9c2a1b7d5e4c6a8b0f1e2d","state":"stored","session":null,"exact":true,"saved_at":1800000600}}}},"exampleType":"examples"}},"exampleType":"examples"},"3206e067-e47e-4438-95bf-8767033e28d2":{"description":"Bad or missing bearer credential.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable public error.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Present only for errors with a stable code.","uniqueKey":"code","typeLabel":"string"},"state":{"type":"string","uniqueKey":"state","typeLabel":"string"},"unsupported":{"type":"boolean","uniqueKey":"unsupported","typeLabel":"boolean"},"outcome":{"type":"string","enum":["unknown","installed"],"uniqueKey":"outcome","typeLabel":"enum\u003cstring>"},"id":{"type":"string","description":"Session ID if a create receipt exists.","uniqueKey":"id","typeLabel":"string"},"request_key":{"type":"string","uniqueKey":"request_key","typeLabel":"string"},"cleanup_complete":{"type":"boolean","uniqueKey":"cleanup_complete","typeLabel":"boolean"},"balance_cents":{"type":"integer","uniqueKey":"balance_cents","typeLabel":"integer"},"session":{"type":"string","uniqueKey":"session","typeLabel":"string"},"session_limit":{"type":"integer","uniqueKey":"session_limit","typeLabel":"integer"},"active_session_count":{"type":"integer","uniqueKey":"active_session_count","typeLabel":"integer"},"available_session_slots":{"type":"integer","uniqueKey":"available_session_slots","typeLabel":"integer"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","state":"\u003cstring>","unsupported":true,"outcome":"unknown","id":"\u003cstring>","request_key":"\u003cstring>","cleanup_complete":true,"balance_cents":123,"session":"\u003cstring>","session_limit":123,"active_session_count":123,"available_session_slots":123}}},"exampleType":"generated"}},"exampleType":"generated"},"a674c4c3-b9bd-4ce3-a7ab-2667c77a89e2":{"description":"Account access denied or rental access unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable public error.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Present only for errors with a stable code.","uniqueKey":"code","typeLabel":"string"},"state":{"type":"string","uniqueKey":"state","typeLabel":"string"},"unsupported":{"type":"boolean","uniqueKey":"unsupported","typeLabel":"boolean"},"outcome":{"type":"string","enum":["unknown","installed"],"uniqueKey":"outcome","typeLabel":"enum\u003cstring>"},"id":{"type":"string","description":"Session ID if a create receipt exists.","uniqueKey":"id","typeLabel":"string"},"request_key":{"type":"string","uniqueKey":"request_key","typeLabel":"string"},"cleanup_complete":{"type":"boolean","uniqueKey":"cleanup_complete","typeLabel":"boolean"},"balance_cents":{"type":"integer","uniqueKey":"balance_cents","typeLabel":"integer"},"session":{"type":"string","uniqueKey":"session","typeLabel":"string"},"session_limit":{"type":"integer","uniqueKey":"session_limit","typeLabel":"integer"},"active_session_count":{"type":"integer","uniqueKey":"active_session_count","typeLabel":"integer"},"available_session_slots":{"type":"integer","uniqueKey":"available_session_slots","typeLabel":"integer"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","state":"\u003cstring>","unsupported":true,"outcome":"unknown","id":"\u003cstring>","request_key":"\u003cstring>","cleanup_complete":true,"balance_cents":123,"session":"\u003cstring>","session_limit":123,"active_session_count":123,"available_session_slots":123}}},"exampleType":"generated"}},"exampleType":"generated"},"f26003e9-dfe3-49c8-ab58-90bdd4acc7b1":{"description":"Unexpected service error.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable public error.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Present only for errors with a stable code.","uniqueKey":"code","typeLabel":"string"},"state":{"type":"string","uniqueKey":"state","typeLabel":"string"},"unsupported":{"type":"boolean","uniqueKey":"unsupported","typeLabel":"boolean"},"outcome":{"type":"string","enum":["unknown","installed"],"uniqueKey":"outcome","typeLabel":"enum\u003cstring>"},"id":{"type":"string","description":"Session ID if a create receipt exists.","uniqueKey":"id","typeLabel":"string"},"request_key":{"type":"string","uniqueKey":"request_key","typeLabel":"string"},"cleanup_complete":{"type":"boolean","uniqueKey":"cleanup_complete","typeLabel":"boolean"},"balance_cents":{"type":"integer","uniqueKey":"balance_cents","typeLabel":"integer"},"session":{"type":"string","uniqueKey":"session","typeLabel":"string"},"session_limit":{"type":"integer","uniqueKey":"session_limit","typeLabel":"integer"},"active_session_count":{"type":"integer","uniqueKey":"active_session_count","typeLabel":"integer"},"available_session_slots":{"type":"integer","uniqueKey":"available_session_slots","typeLabel":"integer"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","state":"\u003cstring>","unsupported":true,"outcome":"unknown","id":"\u003cstring>","request_key":"\u003cstring>","cleanup_complete":true,"balance_cents":123,"session":"\u003cstring>","session_limit":123,"active_session_count":123,"available_session_slots":123}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"843d9498-6aa5-48aa-8108-f009c2276f02":{"ApiKey":{"type":"http","scheme":"bearer","description":"Phone Harness account API key (pck_…). The dashboard may use a Clerk session JWT with the same header. Never put an account key in a URL.","scopes":[],"schemeName":"ApiKey"}}},"servers":{"bcfacf48-4e0a-46da-900c-90d25768345c":{"url":"https://api.phone-harness.com","description":"Production beta"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Phone Harness account API key (pck_…). The dashboard may use a Clerk session JWT with the same header. Never put an account key in a URL.","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Phone Harness account API key (pck_…). The dashboard may use a Clerk session JWT with the same header. Never put an account key in a URL.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"phone-harness","siteName":"phone-harness","title":"Get your account - phone-harness","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T19:10:10.160Z","originalFileLocation":"api-reference/account/get-account.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=\"light\"}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=\"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.\">\u003cmeta data-mint-head name=\"application-name\" content=\"phone-harness\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get your account - phone-harness\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"phone-harness\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://phone-harness.com/docs/api-reference/account/get-account\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://phone-harness.mintlify.site/docs/_mintlify/api/og/v2?division=Account\u0026amp;title=Get+your+account\u0026amp;description=Read+account+identity%2C+credits+and+account+capacity.+can_rent+describes+the+rental-access+gate+only%3B+balance+and+shared+capacity+are+checked+separately+when+cre\u0026amp;theme=42c95747d3f4ff1948666895\u0026amp;signature=7d12c3a4796dc0494f3994392c367dcea766370a965d58dc9bb9d305b3dc7796\">\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=\"Get your account - phone-harness\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://phone-harness.mintlify.site/docs/_mintlify/api/og/v2?division=Account\u0026amp;title=Get+your+account\u0026amp;description=Read+account+identity%2C+credits+and+account+capacity.+can_rent+describes+the+rental-access+gate+only%3B+balance+and+shared+capacity+are+checked+separately+when+cre\u0026amp;theme=42c95747d3f4ff1948666895\u0026amp;signature=7d12c3a4796dc0494f3994392c367dcea766370a965d58dc9bb9d305b3dc7796\">\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=\"/docs/mintlify-assets/_mintlify/favicons/phone-harness/858nNT0arFLNybM8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"phone-harness\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#20231E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://phone-harness.com/docs/api-reference/account/get-account\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/account/get-account.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://phone-harness.com/#organization\",\"name\":\"phone-harness\",\"url\":\"https://phone-harness.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/phone-harness/k6Ti82e3lkhdZ8Co/images/wordmark-light.svg?fit=max\u0026auto=format\u0026n=k6Ti82e3lkhdZ8Co\u0026q=85\u0026s=f1a15d5a898e668d2c240f632b5842a5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://phone-harness.com/docs#website\",\"name\":\"phone-harness\",\"url\":\"https://phone-harness.com/docs\",\"publisher\":{\"@id\":\"https://phone-harness.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://phone-harness.com/docs/api-reference/account/get-account#webpage\",\"url\":\"https://phone-harness.com/docs/api-reference/account/get-account\",\"name\":\"Get your account\",\"description\":\"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.\",\"dateModified\":\"2026-10-31T19:10:10.160Z\",\"isPartOf\":{\"@id\":\"https://phone-harness.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://phone-harness.com/docs/api-reference/account/get-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://phone-harness.com/docs/api-reference/account/get-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://phone-harness.com/docs/api-reference/sessions/create-session\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get your account\",\"item\":\"https://phone-harness.com/docs/api-reference/account/get-account\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://phone-harness.com/docs/api-reference/account/get-account#apireference\",\"headline\":\"Get your account\",\"name\":\"Get your account\",\"description\":\"Read account identity, credits and account capacity. can_rent describes the rental-access gate only; balance and shared capacity are checked separately when creating a session.\",\"url\":\"https://phone-harness.com/docs/api-reference/account/get-account\",\"mainEntityOfPage\":{\"@id\":\"https://phone-harness.com/docs/api-reference/account/get-account#webpage\"},\"dateModified\":\"2026-10-31T19:10:10.160Z\",\"publisher\":{\"@id\":\"https://phone-harness.com/#organization\"},\"isPartOf\":{\"@id\":\"https://phone-harness.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"phone-harness\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"phone-harness","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Overview","href":"/introduction"},{"title":"Start your first phone","href":"/quickstart"}]},{"group":"Guides","pages":[{"title":"Limits and credits","href":"/guides/limits-and-credits"},{"title":"Android","href":"/guides/android"},{"title":"iPhone","href":"/guides/iphone"},{"title":"Session lifecycle","href":"/guides/session-lifecycle"},{"title":"Connect with ADB","href":"/guides/connect-adb"},{"title":"Viewer and screenshots","href":"/guides/viewer-and-screenshots"},{"title":"Errors","href":"/guides/errors"},{"title":"OpenClaw","href":"/guides/openclaw"}]},{"group":"Endpoints","pages":[{"group":"Sessions","pages":[{"title":"Create a session","deprecated":null,"version":null,"sidebarTitle":"Create session","openapi":"/openapi.json post /sessions","href":"/api-reference/sessions/create-session"},{"title":"List active sessions","deprecated":null,"version":null,"sidebarTitle":"List sessions","openapi":"/openapi.json get /sessions","href":"/api-reference/sessions/list-sessions"},{"title":"Get a session","deprecated":null,"version":null,"sidebarTitle":"Get session","openapi":"/openapi.json get /sessions/{sid}","href":"/api-reference/sessions/get-session"},{"title":"Recover a create request","deprecated":null,"version":null,"sidebarTitle":"Recover create request","openapi":"/openapi.json get /sessions/requests/{request_key}","href":"/api-reference/sessions/recover-create-request"},{"title":"End a session","deprecated":null,"version":null,"sidebarTitle":"End session","openapi":"/openapi.json delete /sessions/{sid}","href":"/api-reference/sessions/end-session"}]},{"group":"ADB","pages":[{"title":"Enable ADB","deprecated":null,"version":null,"sidebarTitle":"Enable adb","openapi":"/openapi.json post /sessions/{sid}/adb","href":"/api-reference/adb/enable-adb"},{"title":"Get ADB access","deprecated":null,"version":null,"sidebarTitle":"Get adb","openapi":"/openapi.json get /sessions/{sid}/adb","href":"/api-reference/adb/get-adb"},{"title":"Reset the unlock code","deprecated":null,"version":null,"sidebarTitle":"Reset adb","openapi":"/openapi.json post /sessions/{sid}/adb/reset","href":"/api-reference/adb/reset-adb"},{"title":"Revoke ADB access","deprecated":null,"version":null,"sidebarTitle":"Revoke adb","openapi":"/openapi.json delete /sessions/{sid}/adb","href":"/api-reference/adb/revoke-adb"}]},{"group":"Viewer","pages":[{"title":"Get a snapshot","deprecated":null,"version":null,"sidebarTitle":"Get snapshot","openapi":"/openapi.json get /sessions/{sid}/frame.png","href":"/api-reference/phone/get-snapshot"},{"title":"Get the owner viewer","deprecated":null,"version":null,"sidebarTitle":"Get owner viewer","openapi":"/openapi.json get /sessions/{sid}/owner-viewer","href":"/api-reference/phone/get-owner-viewer"},{"title":"Get the live view","description":"Mint an opaque, expiring view-only viewer URL for a ready session: the same live video as the owner viewer, without input. This is what a watch link opens. The session owner may call it with a bearer credential; a watch link's holder passes its view grant as the token query parameter. Treat the URL as a secret and never log it. Embedding is restricted to the Phone Harness dashboard origin. Reconnection does not extend the phone deadline.","deprecated":null,"version":null,"sidebarTitle":"Get viewer","openapi":"/openapi.json get /sessions/{sid}/viewer","href":"/api-reference/phone/get-viewer"}]},{"group":"Account","pages":[{"title":"Get your account","deprecated":null,"version":null,"sidebarTitle":"Get account","openapi":"/openapi.json get /me","href":"/api-reference/account/get-account"},{"title":"Reset your phone","description":"Forget the saved profile phone: its apps, logins and data. The next session started with your profile_id begins with a fresh phone. Refused while a session holds the phone.","deprecated":null,"version":null,"sidebarTitle":"Reset profile","openapi":"/openapi.json post /me/profile/reset","href":"/api-reference/account/reset-profile"},{"title":"List API keys","deprecated":null,"version":null,"sidebarTitle":"List api keys","openapi":"/openapi.json get /me/keys","href":"/api-reference/account/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"sidebarTitle":"Create api key","openapi":"/openapi.json post /me/keys","href":"/api-reference/account/create-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"sidebarTitle":"Revoke api key","openapi":"/openapi.json post /me/keys/revoke","href":"/api-reference/account/revoke-api-key"}]},{"group":"History","pages":[{"title":"List session history","deprecated":null,"version":null,"sidebarTitle":"List history page","openapi":"/openapi.json get /history/page","href":"/api-reference/history/list-history-page"},{"title":"Get recent history","deprecated":null,"version":null,"sidebarTitle":"Get recent history","openapi":"/openapi.json get /history","href":"/api-reference/history/get-recent-history"}]},{"group":"Service","pages":[{"title":"Check API liveness","deprecated":null,"version":null,"sidebarTitle":"Get health","openapi":"/openapi.json get /health","href":"/api-reference/service/get-health"}]}]},{"group":"Use cases","pages":[{"title":"Connect a coding agent","href":"/use-cases/connect-coding-agent"}]}]},"basePath":"","title":"Get your account - phone-harness","buildId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","deploymentId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D_7my4bd.js","utils-Cq_itTNA.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B5KPEvGz.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DBX-JepP.js","snippetPresets-Bsspz-Ge.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-jcs-2nGf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dp53in7F.js","shallow-Dv9eUdUd.js","getApiPlaygroundDisplay-D8cDwNhi.js","CodeSnippet-DkwXLQor.js","CodeSnippets-DcSgKqs5.js","Page-t8ynOKTD.js","getPastedJson-I2RjoApV.js","icon-BIj57rZC.js","MethodPill-CTwLPWXC.js","DuplicateIcon-BJpFwygY.js","createIcon-C7PorfAe.js","DynamicMarkdown-BBht_uEs.js","SectionHeading-YIBwxbzj.js","axios-vUo_bRtp.js","Markdown--YCeFtOs.js","clsx-CrPa459s.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BWxsj3I0.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fBzVvq7k.js"]}