---
title: "Plan usage this cycle"
method: GET
path: "/api/v1/usage"
tags: ["MapsData API"]
---

# Plan usage this cycle

`GET /api/v1/usage`

## Request

- Base URL: `https://mapsdata.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://mapsdata.ai/api/v1/usage`
- Auth: `MapsData API key` (a scheme the document does not define)

Current cycle usage and the per-scrape ceiling.

`leads_used` counts rows that carried a deliverable email, which is the unit
billing works in. `total_limit` on a job counts rows scraped, so the two are
deliberately different units.

## Response `200`

Successful Response

- Usage
  - `organization_id` string, required
  - `plan_tier` string, nullable
  - `leads_used` integer, required
  - `lead_limit` integer, nullable: Total available this cycle including bonuses. null means unlimited.
  - `leads_remaining` integer, nullable: null when the limit is unlimited.
  - `max_leads_per_scrape` integer, required
  - `can_submit` boolean, required: False when this cycle's allowance is spent.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

---

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