---
title: "Get your account"
method: GET
path: "/me"
tags: ["Account"]
---

# Get your account

`GET /me`

## Request

- Base URL: `https://api.phone-harness.com`
- URL: `https://api.phone-harness.com/me`
- Auth: HTTP bearer

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.

## Response `200`

Account.

- Account
  - `uid` string, required
  - `profile` object: Your own phone: one per account, kept between sessions.
    - `id` string: Pass this as profile_id when creating a session.
    - `state` 'empty' | 'stored' | 'running' | 'saving': empty: nothing saved yet; stored: saved and ready to resume; running: held by a live session; saving: being stored after a session ended.
    - `session` string, nullable: The live session holding the phone, if any.
    - `exact` boolean, nullable: true when the saved phone resumes exactly as left; false when it will come back rebooted with its data intact.
    - `saved_at` number, nullable: Unix seconds of the last save.
  - `email` string, email, nullable, required
  - `name` string, nullable, required
  - `created` number, required: Account creation. Unix time in seconds.
  - `balance_cents` integer, required: US cents of available account credit.
  - `price_cents_per_minute` integer, required: Current metered rate in US cents per minute.
  - `environment` string, required
  - `billing_mode` 'metered' | 'disabled', required
  - `active_session_billing_mode` 'metered' | 'disabled' | 'null', nullable, required
  - `session_create_idempotency` 'v1', required
  - `available` object[]: 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.
    - `platform` 'android' | 'ios': What the phone is: `android` or `ios`.
    - `kind` 'emulator' | 'device': How it runs: an `emulator`, or a real `device` (your own phone on a host).
    - `label` string: Your own device's label, when it has one.
    - `id` string: The choice's id: for your own device, the id to start it with and to reset it, for example iph-622c376ba7.
    - `state` string: 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`.
  - `session_limit` integer, required: Account limit, not a service-wide capacity guarantee.
  - `active_session_count` integer, required: Includes sessions pending cleanup.
  - `available_session_slots` integer, required: Remaining account slots. Shared capacity is checked separately.
  - `can_rent` boolean, required: Access gate only; balance and capacity are checked separately at creation.
  - `rent_blocked_reason` string: Present if can_rent is false.
  - `unnamed` object: What a start that names nothing gets: a temporary Android emulator. The endpoint's rule, not a preference.
    - `platform` 'android'
    - `kind` 'emulator'
    - `temporary` boolean

## Other responses

- `401`: Bad or missing bearer credential.
- `403`: Account access denied or rental access unavailable.
- `500`: Unexpected service error.

---

[API](https://skmtc.dev/phone-harness/apis/phone-harness-api.md) - [All operations](https://skmtc.dev/phone-harness/apis/phone-harness-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phone-harness/apis/phone-harness-api/revisions/5af8941102e5?raw)