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

# Get Account

`GET /v1/account`

The caller's identity, key scopes, and whether a card is saved for
headless orders (`POST /v1/carts/{id}/pay`).

## Response `200`

Successful Response

- V1Account
  - `object` 'account'
  - `user_id` string, nullable
  - `email` string, nullable
  - `auth_method` 'api_key' | 'oauth' | 'session' | 'anonymous_session' | 'internal_service', required — `oauth` for agent connections, `api_key` for manual keys, `session` for a signed-in website user.
  - `scopes` string[]
  - `payment_method` V1PaymentMethod — The card saved for headless API orders (set up on the account page).
    - `object` 'payment_method'
    - `brand` string, nullable
    - `last4` string, nullable
    - `exp_month` integer, nullable
    - `exp_year` integer, nullable
    - `created_at` string, date-time, nullable
  - `payment_method_setup_url` string, nullable

## Other responses

- `401` — Missing or invalid credentials.
- `403` — The credentials do not permit this operation.
- `404` — The resource does not exist or is not visible to the caller.
- `422` — Validation failed; see `error.param` and `error.details`.
- `429` — Rate limit exceeded; retry after the `Retry-After` header.
- `500` — Unexpected failure; safe to retry with the same Idempotency-Key.

## Changes

- **2026-09-07** `35a1cd3bea64` — 1 warning
  - added the new `oauth` enum value to the `auth_method` response property for the response status `200`
- **2026-09-06** `b7e901150c5c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rmfg/apis/fastapi/changes/v1/account/get.md)

---

[API](https://skmtc.dev/rmfg/apis/fastapi.md) · [All operations](https://skmtc.dev/rmfg/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/rmfg/apis/fastapi/revisions/737527fc081e?raw)