---
title: "Who you are, your plan and this month’s usage"
method: GET
path: "/v1/me"
tags: ["Account"]
---

# Who you are, your plan and this month’s usage

`GET /v1/me`

## Request

- Base URL: `https://api.nvoke.run`
- URL: `https://api.nvoke.run/v1/me`
- Auth: HTTP bearer

Returns the account behind the token: profile, plan, verified emails used this month and the allowance. `?sync=1` re-reads the plan from billing first. `billingUrl` is where a human upgrades.

## Response `200`

OK

- object
  - `user` object, required
    - `id` string, required
    - `email` string, nullable, required
    - `name` string, nullable, required
    - `imageUrl` string, nullable, required
  - `via` 'device' | 'clerk' | 'api_key' | 'oauth', required
  - `plan` 'free' | 'emails_1000' | 'emails_2500' | 'emails_7500' | 'emails_20000' | 'emails_50000' | 'emails_100000', required
  - `usage` object, required
    - `period` string, required
    - `emailsVerified` integer, required
    - `emailsLimit` integer, required
  - `maxSearchLimit` integer, required
  - `maxDropDailyLimit` integer, required
  - `account` object, required
    - `createdBy` 'human' | 'agent', required
    - `agentName` string, nullable, required
    - `claimedAt` string, date-time, nullable, required
  - `billingUrl` string, required

## Other responses

- `4XX`: `unauthorized`: No valid token. Send `Authorization: Bearer <key>`.

## Changes

- **2026-10-20** `f7cfd26111a8`: 1 info
  - added the required property `maxDropDailyLimit` to the response with the `200` status

[Operation history](https://skmtc.dev/nvoke/apis/nvoke-api/changes/v1/me/get.md)

---

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