Skip to main content
GET
/
v1
/
rate-limit-status
Get rate limit status
curl --request GET \
  --url https://embed.nova.dweet.com/v1/rate-limit-status \
  --header 'Authorization: Bearer <token>'
{
  "partnerId": "<string>",
  "environment": "SANDBOX",
  "generatedAt": "2023-11-07T05:31:56Z",
  "degraded": true,
  "buckets": {
    "criteria_ai": {
      "limit": 123,
      "remaining": 123,
      "resetAt": 123,
      "resetInSeconds": 123
    },
    "criteria_ai_inflight": {
      "limit": 123,
      "active": 123,
      "retryAfterSeconds": 123
    },
    "scoring_intake_batch": {
      "limit": 123,
      "remaining": 123,
      "resetAt": 123,
      "resetInSeconds": 123
    },
    "scoring_intake_single": {
      "limit": 123,
      "remaining": 123,
      "resetAt": 123,
      "resetInSeconds": 123
    },
    "read_and_ops": {
      "limit": 123,
      "remaining": 123,
      "resetAt": 123,
      "resetInSeconds": 123
    },
    "rate_limit_status": {
      "limit": 123,
      "remaining": 123,
      "resetAt": 123,
      "resetInSeconds": 123
    }
  }
}
Use this endpoint to see your current rate limit status for all buckets. This does not consume rate limit tokens from any bucket other than rate_limit_status. This endpoint requires only a valid API key. X-Tenant-Id is not required.

​
Response

The response includes per-bucket status for all five RPS buckets plus in-flight concurrency status for the criteria_ai bucket. 
{
  "partnerId": "partner_abc123",
  "environment": "PRODUCTION",
  "generatedAt": "2026-02-17T10:30:00.000Z",
  "degraded": false,
  "buckets": {
    "criteria_ai": {
      "limit": 2,
      "remaining": 2,
      "resetAt": 1739787001,
      "resetInSeconds": 1
    },
    "criteria_ai_inflight": {
      "limit": 4,
      "active": 1,
      "retryAfterSeconds": 0
    },
    "scoring_intake_batch": {
      "limit": 1,
      "remaining": 1,
      "resetAt": 1739787001,
      "resetInSeconds": 1
    },
    "scoring_intake_single": {
      "limit": 10,
      "remaining": 8,
      "resetAt": 1739787001,
      "resetInSeconds": 1
    },
    "read_and_ops": {
      "limit": 20,
      "remaining": 19,
      "resetAt": 1739787001,
      "resetInSeconds": 1
    },
    "rate_limit_status": {
      "limit": 2,
      "remaining": 1,
      "resetAt": 1739787001,
      "resetInSeconds": 1
    }
  }
}

​
Response fields

FieldTypeDescription
partnerIdstringYour partner identifier
environmentstringSANDBOX or PRODUCTION, determined by your API key
generatedAtstringISO 8601 timestamp when this status was generated
degradedbooleantrue when Redis is unavailable and values are best-effort estimates

​
RPS bucket fields

Each RPS bucket (criteria_ai, scoring_intake_batch, scoring_intake_single, read_and_ops, rate_limit_status) has:
FieldTypeDescription
limitintegerMaximum requests per second
remainingintegerRequests remaining in the current 1-second window
resetAtintegerUnix timestamp when the window resets
resetInSecondsintegerSeconds until the window resets

​
In-flight fields

The criteria_ai_inflight object tracks concurrent request capacity:
FieldTypeDescription
limitintegerMaximum concurrent in-flight requests (4)
activeintegerCurrently active in-flight requests
retryAfterSecondsintegerSeconds 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

​
Authorization
string
header
required

Use Authorization: Bearer sk_test_* or Authorization: Bearer sk_live_*.

Response

Rate limit status

​
partnerId
string
required

Your partner identifier

​
environment
enum<string>
required

SANDBOX or PRODUCTION, determined by your API key

Available options:
SANDBOX,
PRODUCTION
​
generatedAt
string<date-time>
required

ISO 8601 timestamp when this status was generated

​
degraded
boolean
required

True when Redis is unavailable and values are best-effort estimates

​
buckets
object
required