Usage Logs Download API

Once you have fetched the list of available logs for your account, you could download these logs using Usage Logs Download API.

These logs will contain all the details of the bins accessed on your account, systems used to access these bins, IPs of the users/machine, etc.



/l/:date :date needs to be in DD/MM/YYYY format. 

Request Type


Request Headers

Below are the list of Accepted Request Headers if you are trying to Download Usage Logs.

Request Header Value Required
X-Master-Key <X-Master-Key> Yes
X-Master-Key Required

X-Master-Key is nothing but your Core API Access Key. You will need this Key to access mostly any API end-point on JSONBin. You could find the key on the API Keys page.

Code Samples

  • cURL
curl -v\
  -H "X-Master-key: " \
  --request GET \

Request Response

Success Status Code: 200
.zip file will be downloaded for the requested date
Error Status Code: 401, 404
  "message": "<Error Message>"

For more information on the error codes & errors you might possibly encounter, refer to the below section.

Error Reference

  • 401 Unauthorized
  • 404 Not Found
You need to pass X-Master-Key in the header

In-order to fetch the List of Usage Logs, you need to pass the X-Master-Key header. You can find X-Master-Key on API Keys page

Invalid X-Master-Key provided

You'll encounter this error if you are not passing the X-Master-Key header which is required to authenticate your request while creating Schema Docs or you've passed an incorrect key. In-order to fix this, pass the X-Master-Key header with a value of the API Key which you can find on the API Keys page.

Backup not found for { DD-MM-YYYY }

You'll encounter this error if no access logs are found for a particular date you've requested the logs for.

Create a Free Account

Create an Account View Pricing