@nova-sdk/api
Rate limits
Get Rate Limit Status
Check your current rate limit status across all buckets
GET
@nova-sdk/api
Use this endpoint to see your current rate limit status for all buckets. This doesn’t consume rate limit tokens from any bucket other thanDocumentation Index
Fetch the complete documentation index at: https://nova.dweet.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
rate_limit_status.
This endpoint requires only a valid API key. X-Tenant-Id isn’t required.
Response
The response includes per-bucket status for all RPS buckets plus in-flight concurrency status for thecriteria_ai bucket.
Response fields
| Field | Type | Description |
|---|---|---|
partnerId | string | Your partner identifier |
environment | string | SANDBOX or PRODUCTION, determined by your API key |
generatedAt | string | ISO 8601 timestamp when this status was generated |
degraded | boolean | true when Redis is unavailable and values are best-effort estimates |
RPS bucket fields
Each RPS bucket (criteria_ai, criteria_current_reads, scoring_intake_batch, scoring_intake_single, read_and_ops, rate_limit_status, analytics) has:
| Field | Type | Description |
|---|---|---|
limit | integer | Maximum requests per second |
remaining | integer | Requests remaining in the current 1-second window |
resetAt | integer | Unix timestamp when the window resets |
resetInSeconds | integer | Seconds until the window resets |
In-flight fields
Thecriteria_ai_inflight object tracks concurrent request capacity:
| Field | Type | Description |
|---|---|---|
limit | integer | Maximum concurrent in-flight requests (4) |
active | integer | Currently active in-flight requests |
retryAfterSeconds | integer | Seconds until a slot may become available (0 if slots are available) |
This endpoint is also rate-limited under the
rate_limit_status bucket (2 req/s). Rate limit headers are included on the response.Authorizations
Use Authorization: Bearer sk_test_* or Authorization: Bearer sk_live_*.
Response
Rate limit status
Your partner identifier
SANDBOX or PRODUCTION, determined by your API key
Available options:
SANDBOX, PRODUCTION ISO 8601 timestamp when this status was generated
True when Redis is unavailable and values are best-effort estimates