Current Monthly Usage

Inspect the calling API key's monthly usage, quota, percent used, plan tier, and quota reset timestamp.

GET /api/v1/account/usage

Returns the calling key's current calendar-month usage. Useful for client-side dashboards, quota warning banners, and pre-flight rate-limit budgeting.

Authentication

All endpoints share the base URL https://api.floridapropertyapi.com/v1. Send your API key in the X-API-Key header.

curl -H "X-API-Key: fpapi_test_..." \
  "https://api.floridapropertyapi.com/v1/account/usage"

// JavaScript (fetch)
const res = await fetch(
  "https://api.floridapropertyapi.com/v1/account/usage",
  { headers: { "X-API-Key": "fpapi_test_..." } },
);
const body = await res.json();
console.log(body.data);

# Python (requests)
import requests

res = requests.get(
    "https://api.floridapropertyapi.com/v1/account/usage",
    headers={"X-API-Key": "fpapi_test_..."},
)
res.raise_for_status()
print(res.json()["data"])

Query Parameters

None.

Response (200)

{
  "data": {
    "events_count": 1247,
    "monthly_quota": 10000,
    "percent_used": 12.47,
    "reset_date": "2026-07-01T00:00:00.000Z",
    "plan": "developer"
  },
  "meta": { "request_id": "req_1234567890abcdef12345", "dataset_status": "live" }
}

Field	Type	Description
`events_count`	integer	Successful API-usage events counted this calendar month (UTC).
`monthly_quota`	integer	The key's monthly quota (per plan tier).
`percent_used`	number (2 decimals)	`events_count / monthly_quota * 100`. Zero when quota is unlimited.
`reset_date`	ISO 8601 timestamp	UTC start of next calendar month (when the counter resets).
`plan`	string	Plan tier (e.g. `free`, `developer`, `pro`, `enterprise`).

Error Responses

Status	Code	Cause
`401`	`unauthorized`	Missing or invalid API key.
`429`	`rate_limited`	Rate limit exceeded.
`500`	`internal_error`	Server error — retry with backoff.

Data Coverage

This endpoint reports your API-key usage and is independent of dataset rollout. For reference: parcel-roll coverage is live statewide, while sales history is importing and tax-delinquency coverage is rolling out county by county.

Rate Limits

Every /api/v1/* response (including 429) carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers, plus the IETF RateLimit structured field. See Rate Limits for per-tier quotas and backoff guidance.