---
title: "Account Usage"
method: GET
path: "/v1/accounts/keys/usage-status"
tags: ["Account Info"]
---

# Account Usage

`GET /v1/accounts/keys/usage-status`

Retrieves the current API usage status for the requesting API key.<br> This endpoint helps you monitor consumption and remaining quota. <strong>Running it 2–3 times per week</strong> is recommended for optimal tracking usage patterns.<br> <strong>Note:</strong> <ul> <li>The weekly quote renewals occur every <strong>Sunday at 12:00 a.m. UTC</strong>.</li> <li>There can be a discrepancy between usedQuota and the sum of calls made to individual endpoints because only <a href="https://docs.placer.ai/reference/faqs-1#q-what-api-calls-count-towards-my-quota"><strong>successful calls</strong> are counted</a>.</li> </ul>

## Response `200`

200 response

- UsageStatusResponse
  - `usedQuota` integer — The number of API calls your account has actually <strong>used</strong> during the <strong>current weekly quota period.<strong> This reflects your current API call consumption.
  - `queriedPOIs` integer — The total number of <strong>unique Points of Interest (POIs)</strong> queried through any POI-related endpoints in the <strong>current weekly quota period</strong>. This helps track how many distinct POIs have been requested.
  - `weeklyUsageByEndpoint` object[] — The weekly usage per each utilized endpoint
    - `endpoint` string — Endpoint's method and URI
    - `numOfCalls` integer — The number of calls to the endpoint on the current week.

## Other responses

- `403` — 403 Permission Denied
- `500` — 500 Internal Server Error

---

[API](https://skmtc.net/placer/apis/papi.md) · [All operations](https://skmtc.net/placer/apis/papi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/placer/papi/revisions/e317a0bbbd11/schema)