---
title: "Introspect the calling API key: user identity, owning app, scope, USDC balance and remaining spend allowance — one call."
method: GET
path: "/api/v1/apps/me"
tags: ["apps", "apps-transfer"]
---

# Introspect the calling API key: user identity, owning app, scope, USDC balance and remaining spend allowance — one call.

`GET /api/v1/apps/me`

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- AppMeResponse — Everything an API-key client needs to know about itself in one call. Returned by ``GET /apps/me``. Avoids the older multi-step dance of ``GET /user`` + ``GET /apps/{id}`` + ``GET /balance`` for callers (e.g. the CLI) that only have an ``X-Api-Key`` and want to introspect.
  - `name` string, nullable
  - `email` string, required
  - `balance` number, required
  - `spendLimit` number, required
  - `appId` string, uuid, required
  - `appName` string, required
  - `scope` RouteScope[]

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-27** `7ed1b58c5607` — 1 breaking, 32 warning, 12 info
  - the `header` request parameter `x-api-key` became required
  - added the new `2fa` enum value to the `scope/items/` response property for the response status `200`
  - added the new `activity` enum value to the `scope/items/` response property for the response status `200`
  - added the new `admin` enum value to the `scope/items/` response property for the response status `200`
  - …41 more
- **2026-06-02** `11ba46a28f0a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hevn-inc/apis/hevn-api/changes/api/v1/apps/me/get.md)

---

[API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) · [All operations](https://skmtc.dev/hevn-inc/apis/hevn-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hevn-inc/hevn-api/revisions/7ed1b58c5607/schema)