How to find out your usage

How to find out your usage

How to find out your usage

When receiving a response from Urlbox, it will contain a number of useful headers that you can use to see your current usage:

x-urlbox-request-id: 9a20ac3c-dd71-4906-8025-3e6f01434dce
x-urlbox-accepted-by: devapi
x-renders-used: 79
x-renders-allowed: 100
x-renders-reset: Sat May 25 2024 14:18:57 GMT+0100 (British Summer Time)
x-renders-remaining: 21
x-urlbox-cache-status: MISS
x-ratelimit-limit: 250
x-ratelimit-remaining: 249
x-ratelimit-reset: 1695661076
x-ratelimit-resetdate: Mon, 25 Sep 2023 16:57:56 GMT
x-urlbox-rendered-by: enginelocal
x-urlbox-render-time: 36749

Usage Headers

x-renders-used

This header shows how many renders your account has used in the current billing period.

x-renders-allowed

This shows the number of renders you are allowed in the current billing period.

x-renders-remaining

This shows the number of renders you have remaining in the current billing period.

x-renders-reset

This shows the date and time when your renders will reset to 0.

Rate Limit Headers

x-ratelimit-limit

This shows the number of requests you are allowed to make in the rate limit window (1 minute).

x-ratelimit-remaining

This shows the number of requests you have remaining in the rate limit window (1 minute).

x-ratelimit-reset

This shows the date when the rate limit window resets.

x-ratelimit-resetdate

This shows the date and time when the rate limit window resets.

Other Headers

x-urlbox-request-id

This shows the unique request ID for this request. This can be used to help us find your request in our logs.

x-urlbox-cache-status

This shows whether the response was served from cache or not. If the response was served from cache, it will show HIT. If the response was not served from cache, it will show MISS.

x-urlbox-rendered-by

This shows which rendering engine was used to render the screenshot.

x-urlbox-render-time

This shows how long it took to render the screenshot in milliseconds.