Fetch Bins - JSONBin.io

Fetch Uncategorized Bins API

Using the Fetch Uncategorized Bins API, you could retrieve the records which are not created under any Collection. These records can be sorted in Ascending & Descending order.

This API will only return you the Meta Data of the bins like Bin Id, Created At Timestamp, Private/Public bin etc.

Root

https://api.jsonbin.io/v3

Route

To Fetch the First 10 Bins

/c/uncategorized/bins/

To Fetch the rest of the Bins, pass the Last Bin Id you've fetched from the previous GET and pass it in the below URL

/c/uncategorized/bins/<LAST_BIN_ID>

Request Type

GET

Request Headers

Below are the list of Accepted Request Headers if you are trying to Attach a Schema Doc to a Collection.

Request Header	Value	Required
X-Master-Key	<API_KEY>	Yes
X-Sort-Order	<ascending/descending>	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.

X-Sort-Order Optional

You can pass X-Sort-Order in the header and change the sorting order. By default, it will fetch the records in the Descending order.

Code Samples

cURL
JavaScript (ES6)
Python 3
Ruby

curl -v\
-H "X-Master-key: <YOUR_API_KEY>" \
--request GET \
  https://api.jsonbin.io/v3/c/uncategorized/bins

let req = new XMLHttpRequest();

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

req.open("GET", "https://api.jsonbin.io/v3/c/uncategorized/bins", true);
req.setRequestHeader("X-Master-Key", "<YOUR_API_KEY>");
req.send();

import requests
url = 'https://api.jsonbin.io/v3/c/uncategorized/bins' 
headers = {
  'X-Master-Key': '<YOUR_API_KEY>'
}
data = {}
req = requests.get(url, json=data, headers=headers)
print(req.text)

require 'net/http'
require 'json'

uri = URI("https://api.jsonbin.io/v3/c/uncategorized/bins")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  req = Net::HTTP::Get.new(uri)
  req['X-Master-Key'] = '<YOUR_API_KEY>'
  http.request(req) 
end 

puts res.body

Request Response

Success Status Code: 200

[
  {
      "snippetMeta": {},
      "private": true,
      "record": "<RECORD_ID>",
      "createdAt": "<DATE_TIME>"
  },
  ...
]

Error Status Code: 400, 401, 403

{
  "message": "<Error Message>"
}

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

Error Reference

401 Unauthorized
403 Forbidden

You need to pass X-Master-Key in the header

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.

Invalid X-Master-Key provided

Check if the X-Master-Key you've provided is valid.

Create a Free Account

Create an Account View Pricing

{}jsonbin.io