Usage Monitoring

This endpoint provides real-time information about your API usage, including details on your subscription plan, the total number of conversions, remaining conversions, and the expiration date for current limits.

Endpoint Details

Method: GET

https://api.pdfbolt.com/v1/usage

Example

Below is an example response from the usage endpoint:

{
  "plan": "BASIC_MONTHLY",
  "recurring": [
    {
      "total": 2000,
      "left": 999,
      "expires": "2025-01-29T23:59:26Z",
      "overage": 0
    }
  ],
  "oneTime": [
    {
      "total": 500,
      "left": 350,
      "expires": "2025-06-15T23:59:59Z"
    }
  ]
}

Response Parameters

Parameter	Type	Description	Possible Values	Example Value
plan	string	Subscription plan name.	All plan names	DEVELOPER_MONTHLY
recurring	array	Details of recurring document conversion plan.	Array with objects	[{"total": 2000, "left": 999, "expires": "2025-01-29T23:59:26Z"}]
recurring.total	number	Total number of recurring conversions available.	Any positive integer	2000
recurring.left	number	Number of remaining recurring conversions. Includes 0 if no conversions are left.	Any non-negative integer	999
recurring.expires	string (ISO 8601)	Expiration date and time for the recurring limit.	ISO 8601 datetime string in UTC	2025-01-29T23:59:26Z
recurring.overage	number	Number of overage conversions used for recurring plans.	Any non-negative integer	0
oneTime	array	Details of one-time (non-recurring) credit packages.	Array with objects	[{"total": 500, "left": 350, "expires": "2025-06-15T23:59:59Z"}]
oneTime.total	number	Total number of one-time conversions in the package.	Any positive integer	500
oneTime.left	number	Number of remaining one-time conversions. Includes 0 if no conversions are left.	Any non-negative integer	350
oneTime.expires	string (ISO 8601)	Expiration date and time for the one-time credit package.	ISO 8601 datetime string in UTC	2025-06-15T23:59:59Z