You can read Private & Public bins using the Read API.

Route (READ a specific Bin)
Route (READ a specific Bin Version)
Route (READ the latest Record of a Bin)
/b/<BIN_ID>/latest        # Will always return the last Updated record
Request Type
Request Headers
Header Value Required
X-Master-Key <YOUR_API_KEY> No

X-Master-Key needs to be passed in-order to Read a Private bin. In-order to get the key, you need to sign-up and navigate to API Keys page.

Basic Code Samples
curl -v\
  -H "X-Master-key: <YOUR_API_KEY>" \
  --request GET \<BIN_ID>/<BIN_VERSION | latest>
let req = new XMLHttpRequest();

req.onreadystatechange = () => {
  if (req.readyState == XMLHttpRequest.DONE) {
};"GET", "<BIN_ID>/<BIN_VERSION | latest>", true);
req.setRequestHeader("X-Master-Key", "<YOUR_API_KEY>");
import requests
url = '<BIN_ID>/<BIN_VERSION | latest>'
headers = {
  'X-Master-Key': '<YOUR_API_KEY>'

req = requests.get(url, json=None, headers=headers)
require 'net/http'
require 'json'

uri = URI("<BIN_ID>/<BIN_VERSION | latest>")
res = Net::HTTP.start(, uri.port, use_ssl: true) do |http|
  req =
  req['X-Master-Key'] = '<YOUR_API_KEY>'


puts res.body
Request Response
  "record": {
    "sample": "Hello World"
  "metadata": {
    "id": "<BIN_ID>",
    "private": true
400, 401, 403
  "message": "<ERROR_MESSAGE>"
Status Code Error Message
400 Bad Request
Invalid Bin Id provided
404 Not Found
Bin not found or it doesn't belong to your account
403 Not Found
Bins not associated to any user are now blocked. Contact the admin at for further info
401 Unauthorised
You need to pass X-Master-Key in the header to read a private bin
401 Unauthorised
X-Master-Key is invalid or the bin doesn't belong to your account
401 Unauthorised
Bin not associated to any user account
400 Bad Request
Bin version is invalid
403 Forbidden
Requests exhausted. Buy additional requests at
404 Not Found
Bin version not found