Get Usage

GET

https://api.narrativ.tech/functions/v1/get-user-usage

Returns the authenticated user's current subscription plan and usage across all quota and rate-limit dimensions.

Request

Authorization

Add parameter in header

api-key

Example:

api-key: ********************

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized - Missing Auth Token

🟠401Unauthorized - Invalid Key

🟠404No active subscription found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.narrativ.tech/functions/v1/get-user-usage' \
--header 'api-key: <api-key>'

Response Example

200 - Success

{
  "success": true,
  "plan": "Pro",
  "quota": {
    "daily": {
      "limit": 10000,
      "used": 4321,
      "remaining": 5679
    },
    "monthly": {
      "limit": 200000,
      "used": 87450,
      "remaining": 112550
    }
  },
  "rateLimit": {
    "limit": 60,
    "window": "15 m",
    "currentWindowUsed": 12,
    "remaining": 48,
    "windowResetsAt": 1747339200000
  }
}

Account Content

Get Influencer Categories