General API routes

GET version

Return the current API version.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/version \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"version": "1.0"
}

GET routes

Return a list of API routes and their associated HTTP verb.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/routes \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"routes": [
		{
			"path": "version",
			"method": "GET"
		},
		{
			"path": "routes",
			"method": "GET"
		},
		{
			"path": "page_size",
			"method": "GET"
		},
		{
			"path": "timezone",
			"method": "GET"
		},
		{
			"path": "timezone",
			"method": "PUT"
		},
		// Routes continued...
	]
}

GET page_size

Return the number of resources returned per page.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/page_size \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"page_size": 50
}

GET timezone

Return the current timezone.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/timezone \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"timezone": "UTC"
}

PUT timezone

Set timezone stored under your account.

Required fields

timezone

The new timezone to use for dates. You can view a list of valid timezones here.

Example request
$ curl https://jsonpad.io/api/v1.0/timezone \
	-u username:token \
	-X PUT \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-d '{"timezone":"America/Los_Angeles"}'

Example response
{
	"timezone": "America/Los_Angeles"
}

GET data_size_limit

Return the maximum data size per item for your account, measured in bytes.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/data_size_limit \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"data_size_limit": 1024
}

GET max_lists

Return the maximum number of lists for your account.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/max_lists \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"max_lists": 100
}

GET max_items

Return the maximum number of items per list for your account.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/max_items \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"max_items": 1000
}

GET total_data_size_limit

Return the maximum total data size limit for your account, measured in bytes. If this value is -1, then there is no total data size limit.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/total_data_size_limit \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"total_data_size_limit": 104857600
}

GET total_data_size

Return the current data size for all lists in your account, measured in bytes.

This endpoint will not count towards rate limiting.

Example request
$ curl https://jsonpad.io/api/v1.0/total_data_size \
	-u username:token \
	-H "Accept: application/json"

Example response
{
	"total_data_size": 1024
}