---
title: "Current plan and credits"
method: GET
path: "/api/v1/me"
---

# Current plan and credits

`GET /api/v1/me`

## Request

- Base URL: `https://gmapsleadfinder.com`
- URL: `https://gmapsleadfinder.com/api/v1/me`
- Auth: HTTP bearer

## Response `200`

Plan and credits snapshot

- MeResponse
  - `plan` string, required
  - `creditsLimit` number, required
  - `creditsUsed` number, required
  - `creditsRemaining` number, required: Total spendable (subscription remaining + permanent packs)
  - `permanentCredits` number: Non-expiring credits from one-time packs
  - `subscriptionCreditsRemaining` number: Remaining credits from the active subscription period

## Other responses

- `401`: Missing or invalid API key
- `403`: Plan cannot use agent API

---

[API](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api.md) · [All operations](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api/revisions/8482ef74e4bd?raw)