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

# Get your account

`GET /v1/account`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/account`
- Auth: HTTP bearer

Returns your account: its type and plan, your role and permissions, and which features it has.

## Response `200`

Your account

- Account
  - `id` string, required: an account ID: acct_ and 32 lowercase hex digits
  - `type` 'personal' | 'business', required
  - `plan` 'free' | 'premium' | 'business' | 'service', required: free or premium (Personal), business (Business), or service (no plan limits)
  - `user` AccountUser, required
    - `id` string, required: Your user ID
    - `email` string, required
    - `name` string, nullable, required: Your first and last name together; null when you have none
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
  - `organization` object, nullable, required
    - `id` string, required: The Business organization's ID
    - `name` string, nullable, required: The organization's name; null when it has none or can't be read right now
  - `role` 'owner' | 'admin' | 'member', required
  - `permissions` string[], required: The permissions your role holds
  - `features` object, required
    - `sms_numbers` boolean, required: Saved logins may get Pomerado phone numbers for their sign-in codes
    - `team` boolean, required
    - `passwordless_logins` boolean, required: A login may sign in with a code instead of a password
    - `login_sharing` boolean, required: Saved logins can be shared with teammates (Business only)
    - `advanced_settings` boolean: Your private tools can each have a location, and their builds, changes and runs can use your own proxy (Business only). Left out where Pomerado doesn't offer them

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `500`: internal_error
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/48dac2a3143e?raw)