Read Schema Docs API

You could use Read Schema Docs API to fetch the Schema Doc Validation files you've created or attached with any collection.




Request Type


Request Headers

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

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
  • JavaScript (ES6)
  • Python 3
  • Ruby
curl -v\
  -H "Content-Type: application/json" \
  -H "X-Master-Key: <YOUR_API_KEY>" \
  --request GET \<SCHEMA_DOC_ID>
let req = new XMLHttpRequest();

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

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

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


puts res.body

Request Response

Success Status Code: 200
  "metadata": {
    "id": "<SCHEMA_DOC_ID>",
    "createdAt": <DATE / TIME>,
    "name": "User Validation"
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 Schema Id provided

Check the Schema Doc Id you've passed. You may face this issue if the ID is invalid or the ID doesn't belong to your account.

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 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.

Invalid X-Master-Key provided

You'll faec this error when the X-Master-Key is passed but the ID isn't valid.

Requests exhausted. Buy additional requests at

You'll face this error when you've exhausted all your requests.

Schema Doc not found

Make sure you pass the correct Schema Doc ID or the Schema Doc doesn't belong to your account.

Create a Free Account

Create an Account View Pricing