POST /usage

Check your plan and usage data

Use this endpoint to learn about your usage data.

/usage

GET https://gen.powerpointgeneratorapi.com/v1.0/usage

Headers

Name	Type	Description
Authorization*	String	Bearer <token>

200: OK

{
  "result": {
    "usedSlideCount": 0,
    "plan": "small_business",
    "allowedSlideCount": 1500,
    "subscriptions": [],
    "resetDate": "22 August 2026",
    "totalApiCallCount": 0,
    "successfulApiCallCount": 0,
    "failedApiCallCount": 0,
    "previousMonthUsedSlideCount": 156,
    "subscriptionStartDate": "datetime"
  },
  "isSuccess": true,
  "message": null,
  "fileName": null,
  "fileNameFullPath": null,
  "isValidJson": false,
  "resultType": 0
}

400: Bad Request

{
    "statusCode": 400,
    "message": "Invalid input parameters",
    "details": "{more information}",
}

401: Unauthorized

{
  "statusCode": 401,
  "message": "Unauthorized",
  "detail": "The bearer token is missing, expired, or invalid."
}

429: Too Many Requests

{
  "statusCode": 429,
  "message": "Too Many Requests - usage or rate limit exceeded",
  "detail": "Too many requests: monthly slide limit exceeded."
}

500: Internal Server Error

{
  "statusCode": 429,
  "title": "Error",
  "detail": "An error occurred while generating the presentation. See server logs for details."
}

Example request

cURL

curl --location 'https://gen.powerpointgeneratorapi.com/v1/usage'
--header 'Accept: application/json'
--header 'Authorization: Bearer {add_your_token_here}'

Python

import requests

response = requests.get(
    "https://gen.powerpointgeneratorapi.com/v1/usage",
    headers={
        "Accept": "application/json",
        "Authorization": "Bearer {add_your_token_here}",
    },
)

print(response.json())

JavaScript

const response = await fetch("https://gen.powerpointgeneratorapi.com/v1/usage", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer {add_your_token_here}",
  },
});

const data = await response.json();
console.log(data);