---
title: "Your key, plan and quota."
method: GET
path: "/v1/me"
tags: ["meta"]
---

# Your key, plan and quota.

`GET /v1/me`

## Request

- Base URL: `https://api.jobopportunitiesapi.org`
- URL: `https://api.jobopportunitiesapi.org/v1/me`
- Auth: HTTP bearer

Costs no records. `usage_today` counts REQUESTS today (the per_day burst limit); the billed unit is records: `records_used_month` of `records_limit_month` (null = unmetered key), resetting at `records_reset_at` (00:00 UTC on the 1st). With a country lock (`records_country_lock`) job rows in that country are not counted; company rows still are.

## Response `200`

Key status.

- object
  - `created` string, nullable
  - `key_id` string, uuid
  - `key_prefix` string
  - `limits` object
    - `max_page_size` integer
    - `per_day` integer
    - `per_minute` integer
    - `ranked_per_day` integer
  - `plan` string
  - `records_country_lock` string, nullable: ISO country of a country-locked key (job rows there are not metered).
  - `records_limit_month` integer, nullable: Monthly record allowance; null for an unmetered key.
  - `records_reset_at` string, date-time: When the record allowance resets (1st of next month 00:00 UTC).
  - `records_used_month` integer: Records charged this calendar month (UTC).
  - `renews_or_expires` string, nullable
  - `status` string
  - `usage_today` integer: Requests today (not records).

## Other responses

- `401`: Missing, unknown, revoked or expired key. All four are reported identically.
- `429`: Over your plan's per-minute or per-day limit. `Retry-After` says how long (seconds to the next minute boundary, or to UTC midnight on a daily breach). The body says exactly when the limit resets (`resets_at`, `resets_at_text`) and, when a higher plan exists, links a same-key upgrade (`upgrade_url`).

---

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