{}jsonbin.io

BIN VERSIONS COUNT API

Using the Bin Versions Count API, you can fetch the count of Versions you've created for a specific Bin.

Root

https://api.jsonbin.io/v3

Route

/b/<BIN_ID>/versions/counts

Request Type

GET

Request Headers

Below are the list of Accepted Request Headers if you are trying to Get the Count of a JSON record versions.

Request Header Value Required
X-Master-Key <API_KEY> No
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
  • JavaScript (ES6)
  • Python 3
  • Ruby
curl -v\
  -H "X-Master-key: <YOUR_API_KEY>" \
  --request GET \
    https://api.jsonbin.io/v3/b/<BIN_ID>/versions/count
let req = new XMLHttpRequest();

req.onreadystatechange = () => {
  if (req.readyState == XMLHttpRequest.DONE) {
    console.log(req.responseText);
  }
};

req.open("GET", "https://api.jsonbin.io/v3/b/<BIN_ID>/versions/count", true);
req.setRequestHeader("X-Master-Key", "<YOUR_API_KEY>");
req.send();
import requests
url = 'https://api.jsonbin.io/v3/b/<BIN_ID>/versions/count'
headers = {
  'X-Master-Key': '<YOUR_API_KEY>'
}

req = requests.get(url, json=None, headers=headers)
print(req.text)

require 'net/http'
require 'json'

uri = URI("https://api.jsonbin.io/v3/b/<BIN_ID>/versions/count")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  req = Net::HTTP::Post.new(uri)
  req['X-Master-Key'] = '<YOUR_API_KEY>'

  http.request()
end

puts res.body

Request Response

Success Status Code: 200

  "metadata": {
    "id": "<BIN_ID>",
    "versionCount": 0,
    "private": true
  }
}
Error Status Code: 400, 401, 403, 404
{
  "message": "<Error Message>"
}

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

Error Reference

  • 400 Bad Request
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not Found
Invalid Bin Id provided

You'll encounter this error if the Bin Id you are trying to access is invalid. Hence, ensure that the Bin Id you are passing is valid.

You need to pass X-Master-Key in the header to get version count for the private bin

You'll encounter this error if you are not passing the X-Master-Key header which is required to authenticate your request while creating bins. 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.

X-Master-Key is invalid or the bin doesn't belong to your account

You could encounter this error if the X-Master-Key you've passed is invalid, or the Bin you are trying to access does exists but does not belong to your account.

Bin not associated to any user account

Generally, you will never encounter this error. This error will be thrown if you are trying to access a Bin which was created without a user. These are the records which were created earlier where Authentication was not required to Create bins and hence, we have blocked these bins for countering spammy requests.

Invalid X-Master-Key provided

You need to pass a valid X-Master-Key in the Header

Bins not associated to any user are now blocked. Contact the admin at https://jsonbin.io/contact for further info

Generally, you will never encounter this error. This error will be thrown if you are trying to access a Bin which was created without a user. These are the records which were created earlier where Authentication was not required to Create bins and

Requests exhausted. Buy additional requests at https://jsonbin.io/pricing

You'll encounter this error if you've consumed all the available requests. You can purchase additional requests.

Bin not found or it doesn't belong to your account

Check if the Bin Id is valid and belongs to your account.

Create a Free Account

Create an Account View Pricing